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INTRCDUCTION 


The purpose of this document is to dafine and discuss the Master 
Control Program If €MCP) for the 31000 machines. The cancept and 
design of the MCP wid4 be discussed and the functional 
specifications of the MCP*s operations witt be catalogued. 


The sorts»’ data communications . and data management systems wilt 
not be discussed in any depth in this document. Detaited 
descriptions of these features appear in other Burroughs 
publications (See Retated Documentation betow). 


RELATED OOLUMENTATION 


Name Number 
81000 MCP Utilities PeSe 2712 5579 
B1000 Network Definition Language Peds 2212 3223 
81000 Data Management Systems I1 PeSe 2212 5470 
BL800/B1700 Sort PeSe 2291 6752 
Bi000 Software Operational Guide 1058731 
These specifications are written for those people with 
programming experience and a knowtedge of basic software 
concepts.» Those unfamiliar with operating system desitgr wiit 


gain insight into the Burroughs philosophy of system management. 
Those individuats familiar with operating systems of other 
Manufacturers or of other S8urroughs machines wilt gain an 
understanding of the Master Controt Prograr implemented 
specificaliy for the Burroughs $1000. 


Aliso included in this specification are brief descriptions of 


various functions performed by the microrcoded 1/0 driver 
routines. These same routines are often referred to as *"GISMGE" 
and “I/0 interpreter”. The discussions are necessary for 


compdeteness and for a thorough understanding of the #31000 
operating system of which the [7/0 driver is an integral part. 


MCP II is a modulare supervisory program that assumes cofmaons 
logicadly complex functions to simplify and expedite the tasks of 
programming and system operation. Its most important duties 
inctude such functions as; 
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ca Scheduling» initiations runnings and tersination of jobs 


* Providing a symbolic means of communicating with the system 
white shielding the user from the detail of the hardware 


te Providing a family of common facilities such a5 management 
of input/output operations and file maintenance 


* Managing the systea*’s resources for optimum utilization in a 
multi~orogramming environment 


arMACHINE 


The 81000 is a smalisto-medium scale» generat purpose computer 
SyYSteme Its distinguishing feature is its flexibility» made 
possible through interpretive processing. [In any computer system 
a representation of any process has two components: (1) a family 
of structures representing the state of that process» and ¢€2) a 
series of operators able to manipulate those structures. Untit 
the advent of fourth generation computers» both components were 
represented in the machine hardware itself. A compiler of 
danguage transiator transformed the source code (Ceeger COBOL» 
FORTRAN) ainto a “machine tanguage”™ fobject code) which was 
defined in terms of the hardwara architecture. 


For the set of processes able to be generated oy any oparticular 
programming language» there exists a machine architecture which 
best represents those processes. For instances COBOL is 4a 
character-oriented language and performs decimal arithmetic 
excitusively. Because of its data manipulation featurese it wight 
pest utilize a machine architecture with multicaddress operators» 
capable of performing efficient "noves»” “comparese” and simple 
expression evaluation. Dn the other hand» FORTRAN was designed 


to compute complex mathematical functions. Tt favors a stack 
structure for parameter passing and coapiex expression 
evaluation. It performs binary arithmetic and would prefer 30~ 


to 5SO-bit word sizes. 


The difficulty of designing a hardware structure capable cf 
handling two such divergent ‘4anguages in the most efficient 


manner becomes apparent. It would be possibler in principte art 
leaste to design the hardware in such a way a8 to adecuately 
represent both sets of structures. Howevers this would prove to 


be prohibitively expensive. The typical approach» therefore» has 
peen to either design thea hardware to favor one language at the 
expense of others or to design a compromise structure capable of 
handling severat tanguages» but none itn the most efficient 
manners The wide variety of programming Languages in current use 
has placed a great strain a3n the capacity of the hardware ta 
efficiently execute code compiled from very different tangiages. 
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It is to this problem that designers of fourth generation 
softwares and the 61000 in particulars have addressed theaseives. 
Rather than build a particular structure into the hardware» the 
concept of the “soft machine™ has been daveloped whereby the 
idead environment of structures and operators is program@aticality 
Simutated. 


The B1000 hardware was designed with as Littte exoticit structure 
as possible. Because menory may be addressed to the bit» no one 


Structure 45 anherently favored over any other. The only 
required structure ts that which will allow the simulation of any 
"soft machine™. Thus the range of structures abdte to be 


represented on the 81000 is unlimited. 


As stated previousty» for every compider Language there exists a 
machine architecture within which the algorithms generated by 
that compiler will best run. Qn the 81000 this hypotheticaa 


environment is cadied the "S-machine*™. An S“machine has been 
defined for each tlanguage such that any process may be 
represented in its most efficient or most naturat form» 


unrestrained by any arbitrary hardware configuration. 


Compiters on the $1000 generate code fites which contain €1)3 the 
information necessary to initialize the appropriate S-machine at 
fun timer and €2) the "S-code"™ to be executed on this S-machine. 
Sscode is written in Swtanguager the machine Language for an 
S*machines Execution is achieved by the S“code being 
interpreteds an Soperator at a time» by a micromprogram caiied 
an interpreter. 


2OFIWARE 


The term “software™» as used in this document. refers to aia 
programming supplied by the Santa Barbara Plant. When the tern 
is usedr it most Likely is referring to programs that are written 
in a higherwtevet danguage. This may not always be the case» but 
typically» the term wild refer to the compilers and utility 
programs created by the Programning Activity. 
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The firmware consists of a set of interpreters» those portions of 
the MCP which are microscoded and reside in an entity known as 
the MICRO/NCP» and a program cailed "GI5M0". For each S-tlenguage 
a micro coded program catied an interpreter acts upen the 
hardware and executes the compiied S-code as defined by the 
Ssmachines. The 81000 software has Dean implemented in such a way 
that any number of interpretive structures nay be active in the 


system at any given times This is achieved by dynamically 
establishing» upon demands the Swmachine structure for any 
process. 


For instances the MCP» which is itself a program» is written in a 
high@level tlLanguage>» SDL» that ais designed specificadty for 
writing software. It has its own optimum environment (Cthe SOL 
S*machine) consisting of the structures and operators required 
for software applications. It has its own S=tanguage and its own 
interpreter (the SDL interpreter). Running simultaneousty in the 
system may be another prograg written in a different tlanguage 
Ce.ge» COBOL). This program also has its own Structure Ctha 
COBOL Swmachine)» S-lLanguages» and interpreter. The syste» when 
executing the MOP*5 supervisory functions» assumes the 
architecture of the SOL S-machine and» when executing the COs8cL 
instructions,» takes on the COBOL S «machine structure. This 
switching of interpreters and process environments i185 wanaged 
completety by the software and is invisible to the user of the 
machine. 


The BiO00 MCP has actualiy evolved to its present state. 
Originally» ali functions of the MCP were coded ir SDL. 
geginning with the 4.0 release of the software» the most cormonty 
used routines of the MCP were written in microccode and ptaced in 
GISMO. This resudted in substantial performance improvement se 
Beginning with the 5.1 release of the softwarer these comsonty 
used routines were removed from GISMO and placed in the entity 
mentioned previcusty» the MICROSMCP. 


These snecifications have aiso avolved along with the MCP. Many 
of the functions described herein are now performed by the 
MICRO"MCPe though the furction itself remadns exactly the same 335 
it was when it was performed by SDL codee Since this document is 
intended to be a functional specification of the 81000 operating 
system» all MCP functions are described herein. Whether the 
function is performed by ‘SOL code or by micro code should te 
completely transparent to the users Actually» the functional 
resudt is the same for both»r but the time and resource 
requirements are not identical. The difference is therefore not 
always transparent. 
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Throughout this document» the acronym "MCP" may be referring to 
the MICRO/SCP or to the SOL MCP. In cases where the distinction 
is important» "MCP" wiadl not be used but the two terms mertioned 
above witt be. This document» thens wilt actually be a 
functional specification of the operating system» as it was 
originatly intended to be» though it wild actually be describing 
two separate and distinct programs. Since GISMO is aiso a 
critical part of the operating system» the document may also 
touch upon portions of GISHDO. 


GISMG is a microwcoded family of critical routines common to att 


processes. GISMO may atso be referred to in this document 45 
"CSM™» an acronym for Central Service Modutie. It is a centrat 


module of service routines used by all programs in the system and 
performs three basic functions: 


le Switching of control between alt contending processes in the 
system» 
2» Recognition and queueing of interrupts received from the [71] 


controls or from other processes in the systems 


30 Initiation and management of the I/0 controls connected to 
the wachiness usually at the request of another process. 


Processor atlocations the switching of controt between two or 
more processes» is handled by the "Micro Scheduter™ modute in 
GISMO. This moduie may be thought of as an “Quter Loop*. It has 
absolute controt over the process which wilt be performed next on 
the system. 


Interrupt resolution consists of routines which perform certain 
functions depending on the type of interrupt and cartain other 
criticat conditions. The interpreter in controt senses tha 
interrupt and calis upon GISMO to take the required action. 


GI5M0"s service request modula Csoft I/70) performs the function 
of a hardware device capable of performing a memory access at the 
request of an 1/0 controt. An [70 controi on the 81000 is a 
hardware device which acts as an interface between soft [/0 and a 
peripheral device. It requests access to memory on Behalf of the 
device and manages the device itself. The cothection of [75 
controls is cailed the 1/0 sub-system. 


Typical data transfer operations involve frequent but brief catls 
upon soft I/70 by the I/0 subsystem. The firmware was designed 
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in such a way that between the execution of any two S-operatorss 
the interpreter in control widil check a flag in the precessor 
{called the Service Request Bit) to see if the I/0 sub~system is 
demanding attention. If it is» the interpreter passes control ta 
GISMG which performs the necessary memory access and returns 
controt to the interpreter. 
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TERMINOLOGY AND DEFINITIONS 


Before proceeding with a detaited description of what the MCF 
dees and how it goes about its» it wilt be necessary to define a 
number of terms and data structures whose names are used 
familiarty throughout the document. The reader shoutd krow the 
meanings of the termsr but a thorough understanding of the many 
diverse programming structures presented herein is not recuired. 
The structures are presented onty in the interests of 
completeness» and as a possible aid in understanding the 
narrative descriptions of the MCP*s functions» presented in the 
later sections of the specification.» 


MEMORY MANASEMENT AND MEMORY LINKS 


The MCP organizes and ailiocateas space in memory through the us2 
of fields known as memory Links. Each tink immediately precedes 
the bdock of memory it describes and inctudes such information 
as: The size of that block of memory? the type of use Cif any) 
to which it is put? and pointers to the immediately preceding 
and succeeding links. If the block of memory is ctassified as 
available (Ci.ee» not currently in use by any process)» an 
additional set of descriptors point to the Links of the prior 
availabde and next available biocks of memory. Thus it 35 
possible to search aii tinks or onty those tinks describdiny 
availabie memorye A programmatic description is given betow: 


DEFINE MEMORY.LINK.STZE AS #187 2> 

DECLARE MEMORYsLINK TEMPLATE SITCMEMORY.~LINK »SIZE);, 
DEFINE MEMORY»LINK DECLARATION AS # 

DECLARE O1 DUMMY REMAPS MEMORY LINK» 


2 ML2OISK DSK ADR» 
3 ML»~POINTER © ADDRESS» 
3 ML»JOS»NUMBER BIT{L1LO)» 
3 ML.~TYPE BITC6)» 
3 ML. SAVE BITC 1)» 
2 MLeSTZE BIT(24)>» 
2 ML»~PRIORITY.FIELD BLT(3O)» 
3 ML.~DK -INTERVAL BITC10)>» 
3 ML» CURRENT~OK oINT BITC1I0)» 
3 ML» INCOMING.PRIORITY BITCS)» 
3 ML»~RESIDENCE.PRIORITY BIT(5)» 
4 ML.ARP.WHOLE BITC4)» 
4 ML»RP.FRACTION BIT{ 1)» 
2 ML.FRONT BLIT(2Z4)» 
2 ML.~GATK BIT{24)> 
2 MLAUSAGE.S3ITS BIT(2)» 
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3 Mi»PREVIQUS.STAN»~TOUCH BITC1L)» 
3 ML~CURRENT.»SCAN.»T OUCH BITCLIs#> 


USEC ML.DISK 
eML.POINTER 
oML.TYPE 
aMLe SAVE 
eMLa SIZE 
oMLoFRONT 
oMLBACK 
) OF MEMORYs«LINK»~DECLARATIONG 


DEFINE GeMLeDECLARATION AS#DECLARE 

01 Q.MEMORY»LINK TEMPLATE 
O02 FILLER BITCMEMORYeLINK.SIZE) 
92 GeMLeFe AVL ADDRESS 
O02 Q.NLeBeAVL ADDRESS 


wae w © 


#3 


DEFINE 
TAKE sLO AS#O# 
» TAKE.RIGHTMOST AS#1# 
? 
DEF INE % TYPES FOR "ML.~TYPE” 
CODE AS #O0#s 


AVATLABLE AS 29% 
RN.»S AS H3a% 
MCP.TEMP AS #442 
USER»FILE AS a5#2 
SEGeDICTV AS #642 
MICROCODE cram 24 
DICT.MASTECR AS #84 
QUEUVE.DIRECTORY.~TYPE 
AS #9# 
» MSG.SUFFERY 
AS #102 
» MESSAGE»LIST.TYPE 
AS #1i# 
, TOsBE»FORGOTTEN AS #422 
, DATA.SEG AS #13# 
DBM.BUFFER AS #14# 
TERMINATING LINK AS #1542 
MCP.PERMN AS #1682 
PSR.»MEM AS #1782 
MCP.IQAT AS #182% 
DISKeHEADER AS #198% 
PACK.MEM AS #208% 
SB»CNTNR AS #2182 
SCHEO.MEM AS #2242 
SORT »MEM AS #23#2% 
DCH.MEN AS #248#% 
MICROCODE*NONSOVERLAYASLE AS #2582 


sew Se 8 &S 6 YD 


% 


ee © © Ye + Y YS ES © 
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, QUEUVE.AVL»«BUF.V AS #26# 

» DMSs«DISKeHDR AS#27#R 

, QOMS»STRUCTURE AS #28482 

, DMS» TEMP AS 298% 

» OMS.GLOBALS AS #304% 

, DMSeTEMP»LOCK~DESTR AS #3512 

, XMeMEMORY AS #32¢ 

, PERM»SPOeBUFF AS #332 

¥ 


"TEMPLATE" in the above description is defined as “REMAPS BASE™. 
This 38 not important to an understanding of memory tink 
operation. “ADDRESS” is defined in the ACP symbolic as 
"SBIT(24)". The word "AODRESS”" here is used a5 a denotation —- of 
memory address. Hencee “"ML»BACK™ in the description above is 3 
pointer to the previous semory tink and "ML.~FRONT"™ 415 +a pointer 
to the succeeding linke MLeSTZE will contain the size cf the 
area» in bits» and ML.GROUP is valid onty if the area is in use. 
MLePOINTER witit contain the memory address of the segment 
dictionary entry associated with this memory area. Seqment 
dictionaries are described in the next section. Mi .J08.NUMBER 
widl contain the job number of the program using the area. 
ML.~SAVE» the description of which is defined as "BODLEANs*” is set 
on if the memory area must 62? saved on «disk before it 5 
overtaid. 


AS can be determined by adding the sizes of the various 
components» a memory Link requires 187 bits of storage space. 
Since mewory is allocated dynanicaliys it is often difficult to 
predict with any degree of accuracy exactly how much memory will 
be required by any task. The sizes of ali memory tinks involved 
must be included in the caiculations. This is discussed further 
in a later paragraph. 


SEGMENT DICTIONARIES AND SYSTEX DESCRIPTORS 


Virtuai memory is supported by atdowing process segmentatione dy 
segmenting code» data» and interpreters and dynamicatiy moving a 
segment into of out of memory as required» the system is able to 
function as if it had “virtuality infinite” memory capacity. The 
MCP manages this facility through three structures: Code Segment 


Dictionaries» Data Segment Dictionaries» and Interpreter Segment _ 
Dictionaries. Each dictionary consists of a string of systez 


descriptors each of which describes one segment including its 
length» docation and status. AS a segment is moved in or ott of 
memory its dictionary entry is updated accordingly. 


At run time tha NCP creates the code and data segmant 
dictionaries from information in the orogram"s code file. The 
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interpreter 


code file in the same manner and is referenced by an entry in the 


interpreter 
Ciear/Start 


dictionary» 


into 
given betow? 


SYSTEM DESCRIP IORS 


DECLARE 


time. The run 


structure 

structure of the program contains 
pointers to the code and data segment dictionaries and an 
the interpreter dictionary. 


fixed in mamory at 


index 


A programmatic description is 


01 SYSTEM*DESCRIPTOR TEMPLATE SLICSY.SIZE)> 


4 


DEFINE SY#DECLARATION AS #S5Y.DECLOSYSTEM.DESCRIPTIONRD 85% 
DEFINE S¥sDECL(X) AS #ADECLAREZ 


OL DUMMY REMAPS Xok 
OZ S¥sINUSE 
N2 SY¥MEDIA 
O2 S¥LOCK 
02 SY¥INsPROCESS 


O2 SYeINITTAL 


02 S¥.FILE 


O02 SY.OKAFACTOR 
02 SY.SEGsPG 
O2 S¥sTYPE 


BIT({ ide 
BLITC1L)+ 
BITCi)» 
BITCL)» 


BITCL1)>» 


BITC1)» 


BIT¢3) 
BiIT<{ 7)» 
BiTt4)e 


TQ HELP MEMORY MARKAGEMENT 
Q=DISK» L=S“MEMORY 


TRUE IF THERE [3 AN I/7C IN 
PROCESS FOR THE INFORMATION . 
REPRESENTED BY THIS DESCRIPTOR, 
IF TRUE» “SYpCORE™ CONTAINS A 
POINTER TO THE T/0 CESCRIPTOR.. 
"ADDRESS" 5 READ-OQALY HOTHEA 
COPY» HENCE IF “WRITE” THEN GET 
NEW DISK AND REPLACE ADDRESS. 
THE QBJECT OF THIS DESCRIPTOR 
TS A FILE WHOSE USERCOUNT MUST 
BE DECREMENTED WHEN THIS 
DESCRIPTOR TS RETIRED. 
MEMORY DECAY FACTOR 
MEMOGRY»ACTIVITY AUDITING 
UNITTS FOR SY.LENGTH. 

= BITS 
DIGITS ¢€4 B17) 
CHARACTERS Ce BIT) 
NORMAL DESCRIPTORS 
DISK SEGMENTS 
SYSTEM DESCRIPTORS 
SYSTEM INTRINSIC 
INCIRECT REFERENCE 
ADDRESS GIVES RELATIVE 
DISPLACEMENT IN BITS 
CSIGNED NUMBER). 
B= MICROS 


ied i uo tt oda 


“ag OS UT WIN Re 


BLIT{(36)» 
BITCi2)» 
BIT{24)» 
BIT(24)>3 


O2 SYeAQDRESS 
03 FILLER 
G3 SY¥.CORE 
)2 SYeLENGTH 


PORTs»CHANNEL AND UNIT. 

CORE» OR ADDRESS WITHIN UNIT. 
NUMBER OF UNETS» AS DETERMINES. 
BY SY.TYPE. 


Pe Me RE be PEPE Fe DR ee RE ROM Pe ME re ee PO Pe Pe De FE TE FS we eH Pe RE Pe Re OM OM re 
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% 
DEFINE NO»~DECLARATION AS# 
DECLARE 
OL DUMMY REMAPS NORMAL.DESCRIPTOR BITCNO.SITZE D> 
02 NO»DKeFACTOR BITC3)» 
Q2 FILLER BITCH)» 
O02 ND»ACORE BIT(24)> 
O02 NO.TYPE BITC3)» 
O2 NOeLENGTH BIT(24)38s5 


SY.SIZE 3s defined in the MCP code as eighty. Hence eighty bits 
are required to contain one segment dictionary entry» or system 
descriptor. The use of the term “DESCRIPTOR” in 8100) 
documentation is often misleading and ambiguous. There are many 
different types of descriptors» aii of which have different 
memory requirements and formats. Consequentiy» syster 
descriptors will always be refarred to as such or aS segment 
dictionary entries. 


The comments on the various fields comprising the systenr 
descriptor are largely setfrexplanatory. Perhags som2 
explanation of setected fields wouid be beneficial» however. 
S¥2LOCK is set true if the system descriptor describes a data 
fieatd and if the interpreter is currently accessing the field. 
This is to avoid the situation which arises in 3a simpie 
replacement statement where the sending and receiving fieid are 
both in overiayable segments. in order to do the replacemant» 
both data segments must be in memory situdtaneousty. 


SYINITIAL is true for initialized data onty. The most common 
case of this occurs when executing a COBOL program and the 
programmer has used the value clause to initialize data fields 
and the data fietd itself is in an overtayabte segment. 
SY-ADDRESS may be either a disk or a memory address» depending on 
the setting of SYMEDIA. If it. is a memory address» the most 
Significant tweive bits are ignored. If it is a disk addrass» 
the most significant twelve bits contain the port» channet and 
unit associated with the disk address. . 


INTERPRETER MANAGEMENT» PARAMETER BLOCKS ANG DICTIONARIES 


The 81000 MCP maintains a List or directory of ali files or disk. 
file stored on disk has 4 unique name» which say consist cof up to 
three fields» each of which may consist of up to ten characters. 
Associated wi ife on disk is an item called a "Disk Fite 


Header™. The disk file header serves essentialiy to describe the 
file. Adi of this is described in detail in tater sections. 
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This brief discussion is being inciuded at this paint to 
facilitate the following discussions on interpreters. 


Included in the disk file header is a field which denotes the 
type of fite. There are separate type numbers for data files» 
code files» interpreters» and so forthe Cade files Cprograms) 
and interpreters are further described by the first disk segmert 
contained in the file. This segment is calied the “Program 
Parameter Biock*® “or the "Interpreter  Perameter tock» 
respectively. A detailed description of the orogram pdramter 
biock is presented in a dater section. A programmatic 
descriontion of the interpreter parameter block is presented 
below, 


DEFINE IPS.DECLARATION AS# 

DECLARE 01 DUMMY REMAPS IPB BIIC1440)> 
02 FILLER BITCL1923» 
O02 IP3d*HARDWARE CHARI 1)» 
O2 IP@.sARCHITECTURE.NAME CHAR(i0)» 
O02 IPB~COMPILER.LEVEL BITC8)>» 
O02 IPB.MCP.LEVEL BITC 3)» 
O02 [PG.GISMO-LEVEL BiTC8)» 
92 IPB»ARCHITECTURE ATTRIBUTES B1TC39)» 
O2@ FILLER BIT{56); 

a> 


IPB»HAROWARE wilt contain either an "SS" or an "M"» depnendirg upon 
whether the interoreter was generated for an S=memory or an 
M-memory processor. Aili 81899"s are considered to be N-memory 
processor Se IPB»ARCHITECTURE «NAME will contain the generic name 
of the compilers such as COBOL or FORTRAN. IPR@.COMPILER.LEVEL 
wiidl be a number which wiil correspond to the release tLevet of 
the softwares» as described below. IPBMCP.LEVEL» [PH.~GISMO.LEVEL 
and IPBw»jARCHITECTURE.ATTRIBUTES are parts of the interpreter 
verification feature of the MCP. 


The 81000 MCP inctudes facilities to recognize the hardware 
configuation it is executing upon and select the corresponding 
interoreter from the disk directory. All orograms which are 
compiled for execution on a 81990 widid have an interpretar "TYPE" 
requested the program parameter block of the code file Cdescrided 
in a later section)» or the specific name of the interpreter to 


be used. As exptiained in a later sections the program parametar 
block contains space for three names to be associated with an 
interpreter. For discussion purposes heres the three names wilt 


be referred to as the "PACK" namer the "FAMILY" name ard the 
"OFF SPRING” name. 
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The Bi000 compilers generate the tast two names af the 


interpreter onty. The family name generated always corresponds 
to the tanguage the program is written ins such as “COBOL™ or 
"FORTRAN". The offspring name is atiways one of the reservad 
words "INTERP™» "DEBUG" or "TRACE™. At BOS» the MCP modifies the 
offspring name by concatenating one numeric chéracter denoting 
the compiler tavel and either the character "*M" or "S™ depending 
upon whether the machine is equipped with an S-mtemory or an 
M-memory processor . 


The tevel number concatenated is contaired in the program 
parameter block as “*PROG.~COMPILER.~LEVEL"™. Every time the 
compilers are changed in such a manner that the interpreter must 
aifso be changed» the Level number generated by the compiter is 
incremented. The interpreters are then modified accordingty and 
released to the fieid under a new name. The new name wild be the 
same as the old one» except for the tevel number contained in the 
Name « For a CO80L program which is being executed on a 
Bi720-series machine and had been compiled by the 4.1 COBOL 
compiler» the MCP wiift generate “COBOL"/"INTERPIM*™ as the 


interpreter name to be used for the execution. Tt shoutd be 
noted that this feature was first included in the 4.1 software 
redease. Level numbers were not included in the progqran 


parameter block prior to the 4<.1 release. 


Qnee the interpreter name is generated» the disk directory is 
searched for the interpreter. Upon finding the interpreters the 
MCP wild bring it into S-memoryrs if it is not already there» and 
construct an antry in the “"INTERPRETER.DICTIONARY™. ALt 
interpreters are rerentrant on the 681000. Alt of this is 
described in greater detait in the paragraph which foilow. Fach 
antry in the interpreter dictionary has the following format. 


DEFINE ITO-DECLARATION AS#DECLARE 
O01 DUMMY REMAPS INTERPRETER.OICTIGNARY » 


O2 10.S5EG6.0I1C SY¥2O5CR» 
O02 IDeENTRYINJUSE BOOLEAN» 
O02 ID~RSONT.USERCOUNT BITC7)» 
~ 02 1D~TOTAL~USERCOUNT BITC)» 
O2 IDsaMAX «MeASITZE BITC4)> 
92 IDPARTIAL.B81T BOOLEAN» 
02 IDs«BLOCK.COUNT BITC4& dy» 
92 FILLER BITC19)» 
O02 [DeMe»PRESENCEWSIT BOOLEAN» 
D2 I10D.MsADDR BITC12)» 
02 10.TOPN BIiTC4)» 
02 ID-MEDIA : BITC2)» 
92 ID.LOCK ~ BOOLEAN» 
02 FILLER BIT €13)>» 


02 IDTYPE BITC&)» 
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N2 GDsAQDRESS BITC36)>» 
O3 FILLER BITC12)» 
O03 I0.CORE BIT(24)» 
02 IBDeLENGTH BITC245 583 


There is one entry in the interpreter dictionary for each 
interpreter presently in usee The [1/0 driver is atways the first 
interpreter enterad in the dictionar y» the Micro MCP ais the 
second entry and SOL is atways the third entry in the dictiorary. 
On the 81000» it is possible ta segment interpreters. 
Consequantiys a code segment dictionary is constructed for each 
interpreter as it is brought into memory. The system descriptors 
the first item in the interpreter dictionary» is a pointer to the 
interpreter’*s code segment dictionarye Interpreters may ba 
segmented» exactly as programs are. The same routines in the MCP 
are used for handling program segments and interpreter segqmrerts. 


A certain amount of information about each program currently 
being executed is maintained in memory by the MCP. Tne fieid in 
which this information 5 maintained is known as the Run 
Structure Nucleus of the program. It is abbreviated as 
RSeNUCLEUS. In the RS.~NUCLEUS» there is an index into the 
interpreter dictionary. Ati programs Deing executed at any given 
time which are using the same interpreter widt have the same 
index in the field in their respective nucleus. In this manner, 
interpreter rementrancty is accomplishad. 


The remaining fietd in the interpreter dictionary entry wiil not 
be described tn detail at this point. For a more detailed 
description of interpreter managements the reader is referred to 
the section of this document which deats with "memory 
management. It should be sufficiant at this point to say that 
ail interpreter segments except the first are treated as ordinary 
code and arse considered overiayable. The first segment of aach 
interpreter a5 not treated as code and is not overlayadle, 
however. 


The [70 drivers» which is considered an interpreters is an 
exception to the above statements. 


CODE FILES» PROGRAM PARAMETER BLOCKS AND FILE PARAMETER BLOCKS 


The code file of every program aust contain tuo types of records 


to altow. the | MCP to manage the execution of that progran: the 


nF ito Parameter Block” CFP B De and | the “Progran PRL aulect! 


tO Paps ca poenoramenceead 


one entry ‘tor a trace file. 
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The first 28890 bits <two disk segments) of every code file is the 
"Program Parameter Biock™ £PP8) whose format is rigidly defined 
by the MCP. Every compider generates a PPB of the same format. 
It provides» for the MCP» all the vital statistics of the program 
inctuding: The prograa*s name? the name of the interpreter to 
be used during executions the relative addresses of the FP8"s» 
IPB» code segment dictionary and data segment dictionary» memory 
requirements for the program’s executions and tracing 
information. 


At run time a working copy of the PP3 is written into a terporary 
or permanent tog Cas dictated by the system options). The first 
two segments of this four segment entry are an exact copy of the 
PPB from the code file. Another segment is generated by the MCP 
and documents certain features of that particular execution. A 
final segment is reserved for an abnormal termination message. 


[lf the code file is an interpreter code fite>» it contains an 
additionad segment cailed the "Interpreter Parameter Block". It 
contains information concerning the software compatibility of the 
interpreter. A ftetd in a orogram"s PPB specifies under which 
interpreter it wiil run. When the program is scheduted for 
executions the IPB of the interpreter named in the PPB is checked 
to insure that the interpreter is compatible with both the code 
file and the system software. The HCP informs the system 
operator via a SP93 message if the interpreter cannot runs Refer 
to the appropriate MCP Listing for a programmatic description. 


The “peated by 
the compiter from the user's file attribute iecleraciense its 
format is rigidity defined by the MCP» and it contains the vital 
Statistics which allow the MCP to manage the file's usage. When 


a job is scheduled for executions a working copy of the FP®@ is 
written into a permanent or temporary tog (depending on systan 
options). In addition to recording the fiie"s attributese the 
MCP documents the use of the file during that job's execution. 
It records such information as the number of times the file was 


opened and closed; the totad amount of time the file was opens 
the number of records read; the number of Ii/70 errors: and the 
file type. Refer to the aporopriate ACP tisting for a 


programmatic description. 


FILE INFORMATLON BLOCKS .) eo 
eg 


As each file is opened by the user program» a Structure known as 
ation Block (FI8) is created in memory b the MCP. 
The FI3 contains all information necessary for the MCP to perforn 
normal» requested>s I/0 operations on the file. Much of the 
information in the FIB8 is taken directly from the FPS. Qther 
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information in the structure is inserted by the MCP» based upan 
the characteristics of the peripherai device assigned to the 
file. Device assignment is discussed in the section of this 
specification which describes the Open Communicate. 


Fils"s vary in size» depending upon the type of device assigqned to 
the file. Due to the amount of information which must be 
maintained» a disk file FIB is much targer than that of a card 
punch file» for example. 


170 descriptors and buffer memory areas are allocated and 
initiadazed by the MCP at the same time. There will therefore te 
one memory dink only» for each file that is active in a progran. 
Buffer areas and descriptors are not normally shared tetwean 
files» though the Data Management subsystems the Data 
Communications subsystam» the Relative file implementation and 
the Indexed file implemeration offer some exceptions te this 
ruie.e 


A complete structural description of the FI@ wiit rot be 
presented herein» due primarily to the length of the structure. 


Also» the FIB is of interest to the various portions of tha 
Uperating System only.» The programmatic description of the 
structure is readily evailabie in the MCP Listing. Sizes of 


Figs*s for the different peripheral devices are presented in the 
following table. 


File Assigned to: Size in fits 
Reader “Sorter 742 
Printer 124 
Remote Device 557 
Tape 12% 
Disk : 979 
Queue 385 
ALL Other Devices 612 


RUN STRUCTURE 


The struc i hat represents the state of any process 
is the run structure. Each process has a wnique run structure. 
nena Job Ts tnt tTat ized before execution» the MCP creates the 
run structure from an analysis of the program*s code file» and 


adds certain information at wilt need for management of the 
execution. Aid run structures are Linked together by priority. 
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Arun structure consists of 4 program’s data or address spacer 
the MCPs rial space calied the run structure rucieuse and 
the file ‘and data segment program's — ‘address 
spacer residing between its base and limit registers» is that 
area of memory that may be accessed and manipulated by the 
program itself. A program*’s base register iS a memory address 
that marks the tower bound of its addressabte space- The Limix 
register specifies the wupperbdbound. A program may not access 
memory that i185 outside its own base to limit area» though this 
tenet is enforced by the interpreters and not the MCP. 


A program’s address space may contain booth resident ani 
overtayable data. The resident data area contains those fields 
which wilt be present in memory throughout the duration of the 
executione The overlayabtle data space contains segmented data 
which may be brought into or out of memory as needed. 


RUN STRUCTURE NUCLEUS 


The Run Structure Nucteus is an area structured and saintained by 
the MCP and contains the essential information about the program. 
it resides in memory directty above the program’s Limit register 
and is accessibie by the MCP and the program’s interpreter. It 
contains such information as: 


* Pointers to 


BASE AND LIMIT 

SEGMENT BDICTIGNARIES {CODE AND DATA) 
FILE OICTIONARY 

INTERPRETER DICTIONARY ENTRY 

NEXT RUN STRUCTURE (BY PRIGRITY) 
CODE FILE ON DISK 

DISK LOCATION OF RUN STRUCTURE IF "ROLLED OUT" 
PROGRAM*s LOG ENTRY 

VIRTUAL DATA SPACE ON DISK 

NEXT INSTRUCTION TO BE EXECUTED 

CMS POINTERS 


a Structures necessary for communication between the orograr and 
the MCP 


* Fields to reflect the state of the S=machine 


* Fieids for orogram switches 


A programmatic description may be obtained from the MCP Listing. 
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DATA AND FILE DICTIONARIES 


The data segment dictionary resides at the eng of the Run 
Structure Nucdieus and is pointed to by a fietd in the nucteus.e 
If there is no segmented data and the user has not requested that 
his resident data area be initialized» then the pointer wild be 
nudi» and there widll be ro dictionary. 


Each entry in the dictionary is an BO~bit system descriptor 
pointing to one data seqment. © 


The dast element of a run structure is the fite dictionary. 
There is one 80-bit descriptor for each decdared file plus one 
additional descriptor for a trace file tused for tracing). While 
a fide is open» its dictionary entry points to the file's FI in 
memory. If a file has never been opened» its entry is null. If 
a file has been temporarify closed Cinses»r "CLOSE ROLLOUT")» its 
dictionary entry points to its FIB which has been written to 
disk. After a permanent close» the file's dictionary entry wilt 
again be null. 


RE-ENTRANT PROCESSING AND CODE SEGMENT DICTIONARIES 


The B1000 MCP allows rewentrant processing» the ability of two or 
more processes to usa the same code segment dictionary and> 
therebyr the same code. The code segment{€s) and code segment 
dictionary reside outside a program*s run structure» anda fieit4 


in the run structure auctleus points to its code segment 
dictionary. A structure catied the segment dictionary container 
contains the information necessary to govern the use of a 
particular code segment dictionary-s When a job 4s being 


initiated for execution» the MCP determines wheather or not the 
code segment dictionary desired by the job is adready in use. [f 
it is» that dictionary witt ba used. The segment dictionary 
container reflects» among other thingse the number of processes 
using the dictionary it describes. If there is more than one 
user, the segment dictionary container wilt remain in memory 
until ali users have completed execution. 
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THE 270 SUBSYSTEM 
This section of ‘the specifications is a description of: 


1. I/0 Descriptors 
2e GIS4O Operation 
1. Channel Tabte 
2«o GISMO/Hardware Interface 
Le CA/SRCO Cycles 
2e Processor 1/9 Instructions 
3-2 Service Request 
4. Status Counts 
Se Data Transfers 
$52 I70 Chaining 
4. Disk [1/0 Chaining 
5- Disk IVG Overlapoed Seek 
6. Tape I[/0 Chaining 
3. Monitoring of Peripheral Status 
ie I/0 Assignment Table 
20 Unit Mnemonics 
5» Teast and Wait I/D Operators 
4e STATUS Procedure 
5 Disk Identification = Pack Labeis 
6» Pack Information Table 
7. Tape Labedttinge Initiadization and Purging 
8 Tape PE/NRZ Exchanges 
42 File Structures 
1. Conventional Fiiles 
1. File Attributes 
2e File Naming Conventions 
3. Logical Disk Files 
4. Physical Disk Files 
1. Disk Soace Aldocation 
2e File Access and Identification 
30 Disk Fite [Identification 
40 Disk Fite Header 
Se Multi-Pack Fides 
1. Base Packs 
2. Continuation Packs 
34 Mudti~Pack Fite Information Table 
4. Multi "Pack File General estrictions 
5S» Printer Fides 
1. Logical /Physicai [70 Relationship 
2» Logical Page Implementation 
7s Printer and Punch Backup Capabilities 
1. Backup File 34o0cking Factors 
2e Backup Fite Control Information 
3. Backup Fide Record Format 
2e Relative Filies 
1. Direct Files 
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ee Data Structure 
32 Disk Initialization 
4e File Parameter Blocks 
5- Disk Header 
6» File Information Biocks 
fe. Communicate ODperators 
3. Indexed Sequential Files 
1. Direct Files 
2e Index Files 
3. Ciuster Files 
4. Data File Structure 
Se Index File Structure 
Oo». Memory Structures 
1. FIi8 Dictionaries 
2» User Specific Information CUSI) 
3 File Globat Information (GLOBALS) 
4. Structure Descriptor 
Se Disk File Header Extension 
Ye Available Space Atiocation 
8. Index Fite Table Splitting 
9. Current Record Pointer 
10. Current Maintenance 
11. Buffer Management 
i2. Buffer Descriptor 
13. Concurrent Update Operations 
3» The I/0 Error Procedures 


There is some overdap between the information contained in this 
section of the specification and that contained in the Demand 
Management section of the document. The Demand Management 
section was orijginaliy intended to cover the management of the 
peripheral after it had been assigned to a user as a file; the 
1/0 Subsytem section was intended to cover the managemant of the 
device up to that time. This division is not always fpossibter 
Darticudarly in the case of disk devices. fhe reader may have to 
refer to both sections of the document to find the answer to a2 
specific question. 


240 QESCRIPTORS 


Normal state programs raquest I/0 functions in a symbotic fashion 
feege»s Write a Record). The MCP must transform these expressions 
into explicit 1/0 operators catted 1/0 descriptors. An I/) 
descriptor aidtows the “CP to communicate directly with 2 
peripherait device via the soft I/70 routines of GISMO. GISMJ 
Manages the execution of these operators By the I/70 subsystem. 
Each 1/0 descrigtor provides such information as the type of [73 
operation requested» source or destination memory addresses» tha 
device which is to execute the operatorss and space for result 
information used when control is passed back to the MCP. Certain 
other fields vary with the type of descriptor and contain 
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information pecudiar to its specific function. 


Any number of I/70 descriptors may be Linked together to form a 
Singte “"chain* and “dispatched” in one MCP operation to tessen 
the MCP*s interaction with the I/0 subsystem. 


The transformation of togical I/0 requests to physicaet [/0 
descriptor maniputation is discussed in the Demand Manegement 
section of this specification. The discussion below is intended 
to describe the operations performed upon the descriptor after it 
has been transformed. A programmatic description of an I/f) 
descriptor is given betou. This particutar descriptor is typicat 
of one which might be constructed for a disk file. 


DEFINE TO.DESCeDECLARATION AS #2 


DECLARE 01 DUMMY REMAPS TO.BESC 

» 92 I10.RESULT WORD 

> 03 I0.COMPLETE BIT €1) 

» O03 10.EXCEPTION BIT €1) 

ra 03 [0.PAaACK».NOT~READY SIT (1) 

» 03 I0.D0ATA~ECC.ERROR BIT €1) 

» 03 FILLER BIT €1) 

» O03 I[0.MEM.PARITY»ERROR BIT C1) 

» 03 [OWRITELOCKOUT Bit (1) 

, O3 FILLER BIT (2) 

, 03 IG.sADDRESS.~PARITY.~ERROR BIT €1) 
» 93 ITOSECTOR~ADDRESS.ERROR BIT €1) 
° 03 I0-SEEK.~TIMEQUT BIT (1) 

, 03 FILLER BIT (3) 

» 03 ID TRANSMISSLTON»PARITY ERROR BIT €1) 
» O03 I[O.RESULT.BI1T.17 BIT €1) 

» 03 I10.PORT.~RS BIT (3) 

, O03 ID-CHANNEL RS BIT €4) 

» Q2 I[0.LINK ADDRESS 

? 02 10.0P WORD 

» 03 %I0.0P..0P BIT (3) 

, O3 I10.0P.m FIT (1) 

, 03 10.0P.wW Bit ci) 

» 03 I[0.0P.¥ BIT (1) 

, O03 IGQ.0P.E BIT ¢€1) 

, 03 10.0P.0 BIT (1) 

» 03 [0e0P.ANN BIT (3) 

, 03 FILLER BIT €5) 

» 03 I0.0P.P Bit €1i) 

» 03 ‘FILLER BIT £3) 

’ 03 I0.0P.UNIT BIT (4) 

, 02 0.BEGIN - ADDRESS 

» 02 I[D.END ADDRESS 

, O02 FO.DISK.ADDRESS ADDRESS 

» O02 IO..M.EVENTS BIT 8) 

» 03 ILOM»AEVENTS.~£OC BIT €1) 
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» O03 IO.M.sEVENTS.~SIOC BIT {1) 

, O03 FILLER Bit €1) 

» O03 IDM.EVENTS»INT.M BIT {1) 

» O03 LZOMeEVENTS»SsINT.SENT BIT (i) 

» O3 I[D.M~EVENTSsMeINT.SINT BIT <1) 

» 03 FILLER BIT (€1) 

» O3 fO.MeEVENTSeINT.S Bit (1) 

? 02 [0.MCP.10 ait €16) 

» O02 I0.Fi3 ADDRESS 

, O02 10.FI3.LINK ADDRESS 

, 02 [O.BACKeLINK ADDRESS 

, O02 L0.PORT.»CHAN BIT (7) 

, 03 I10.PORT SIT €3) 

» 03 ZOsCHANNEL BIT (4) 

, 02 I[0.BEEN.» THRUAERROR BIT (1)#; 


GI3¥Q = THE 120 ORIVES 


With the exception of the MulticLine Control used on Data 
Communications configurations» on the 81000 hardware the I/0 
controls have no direct connection with main memory. Ati data 
transfers between the controis and memory must go through the 
processore GISM0O is a seat of micreo-coded routines whose primary 
function is to interface between the MCPs and the actual 
hardware. This aitows the MCPs to view the 1/0 subsystem as an 
I70 processors The MCP can initiate I/0 Descriptors and GIS5#D 
widd handde initiation of the control» data transfer and 
termination. The MCPs can queue severat descriptors for 
execution by a controis by property setting the tink fiedids in 
the descriptorss and GISND widd initiate each one in turn. 


User programs make requests to the Micro MCP» and sometimes the 
Micro MCP must ask that the request be handied by the S.MCP».» but 
in either caser the MCP wilt pass the request to GISMO who in 
turn wild pass it on to the I/0 controt. 


The 1/0 subsystem allows fifteen controts or channels te be 
connected to any machines After GISMD initiates a contrels» it 
dees not wait for completion of the operation but returns controt 
to its calier. Consequaentiy» oner and possibly more operations 
may be in process on the machine at any given tite. At any given 
moment» howevers when GISMO is executing it may only address one 
control. 


The primary communication between the MCPs and Gi5S4G is througn 


the I/0 descriptor $s. The S3.4CP wilt initiate I/0 operations 
using the DISPATCH S-operator and the ™.MCP contains micro-code 
to perform a similar function. This S-operator requires to 


parameters» the port and channed of the device being addressed 
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ang the memory address of the descriptor. The 1/0 decsriptor 


contains adi of the information needed by GISM0 for the 
operations 


An I/0 descriptor is usually located by its “Reference Address"» 
the memory address of the result descriptor fietd of the I/73 
descriptor. The resuit dascriptor field is often referred to as 
the "RS fieitd™» or Result Status field. Ali of the descriptors 
associated with a given controt will be tinked together in 
memoryr by setting IO.LINK to the memory address of the RS fietd 
of the next descriptor. The descriptors are also tinked in the 
reverse diractione using the [0.BACTKeLINK field» to facilitate 
adding and deteting descriptors. A Link field may not be zeror 
but a descriptor may bea dinked to itself. 


The Reference Address points to the RS fietd. Each RS fietd is 
twenty-four bits in tength. The bits in the RS fietd have 
different meanings at differant times. GiSmMO is most concerned 
with the setting of the bits when the 1/70 is initiated. Tha MCPs 
are more concerned with the setting of the bits when the I/0 is 
complete. When the descriftor is ready for initiations the R5 
field is formatted as shown in the foidowing diagram. This fietd 
is usuadty referred to as the result status field when the 
descriptor is ready for execution or is in process and as 4 
resuit descriptor fieid when the I/0 operation is compiete. 


Sits O-1 = RS Status Bits 


00 = Ready to be Executed 

1/90 Currenttiy in Process 

10 - [70 Comolete with no cCxception 
11 - 1/0 Complete with Excaption 


i) 
ray 
i 


Bits 211 ~ Gismo Toggles 


MCPs may not alter any bits in this field if 
RS Status = 91. 


Bits 12°14 - Port to which this 1/0 38s directed. (Not used) 
sit 15 ~ Interrupt requested on I/70 Completion. 


Bit 16 ~ High-Priority interrupt requested on I/D 
Completion. 


Bits L7°19 - Port to which interrupts are to be sent upon 
1/0 Completion CAdiways Processor Tero). 


Bits 20-23 - Channel on which I/0 is to be oerformeds 
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The leftmost bit of an RS Field is always set when the operation 
is comptete.j Consequenttiy» storing a resudt descriptor tocks the 
descriptor to GISMO. The MCP may tock a descriptor as wetis» iif 
the status field is not O1. Gismo will only initiate "ready" 
descriotorse those whose status Bits are equad to O56. When the 
operation is initiated» GISMD sets the status bits to OL. The 
GISM0O toggles area jis used by SISMD when an I/09 is in process ta 
Store information which it needs concerning the operation. 


CHANNEL TAQLE 


Another structure associated with peripherat management is the 
channel table. There is one channel table for each port and eacn 
element of the table describes one channel of that port. While 
GISMO uses the I/0 descriptor to communicate directly with the 
I/0 subsystems the channeid table is a structure for passing 
information bDetween the MCP and GiI5MO. The channel tabte 
reflects the status of a particular channel. Certain information 
is passed to GISMO during a “dispatch” operation and is used by 


soft i790 in managing the execution of that operation. Certain 
fields are updated before GISMD passes control back to the MEP 
which diract the courses of action the MCP will take. A 


programmatic description is given beion: 


DEFINE CHANNEL .TASLE.DECLARATION AS # % 
DECLARE 01 DUMMY REMAPS CHANNEL.~TABLE % 


, O2 CHANNEL.BUSY BOOLEAN &% 
» 02 CHANNEL -PENDING BOGLEAN & 
, 02 CHANNEL EXCEPTION BOOLEAN & 
, 02 CHANNEL .PAUSE BOOLEAN & 0 = TAPE» DISK» CAS 
, 92 CHANNEL OVERRIDE BOOLEAN 2% 
? O02 CHANNEL »-E XCHANGE BOOLEAN 2% 
’ 02 CHANNEL.~OLD.MODE BOOLEAN % 
, 02 CHANNEL.INTEGRITY BOOLEAN % 
» O2 CHANNEL .NG»HALT BOOLEAN &% 
, 02 FILLER BIT €3) % 
» O02 CHANNEL.~TYPE BIT (4) &% DEVICE TYPE FOR DUMP 
x TYPE = 9 = SERTAL DEVICE 
% TYPE = 1 = DISK 
A TYPE = 2 = TAPE 
x TYPE = 3 = CASSETTE 
, G2 CHANNEL.LAST BOOLEAN &% DELIMITS CHAN TABLE 
» O02 CHANNEL -EXCHANGE.PC BIT (7) & 
, O03 CHANNEL-EXCHANGE.P BIT €3) % 
’ O3 CHANNEL-~EXCHANGE.C BLT €4) % 
» 02 CHANNEL.REF -ADOR ADDRESS 2 
> # > R 


In the CHANNEL.~TABLE» SUSY is set and reset by GISMOG onty. I[t is 
set when the control is busy. PENDING is adso set and reset by 
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GISMG. It 3s used on tape and disk devices onty and it telis 


GISMO to continue idinking through the head of the queue. 
EXCEPTION is used on adil devices except tape and disk. It causes 
GISMG to inhibit dispatch operations on the channet until a prior 
exception condition has been handied by the MCP. 


PAUSE js also known as the TIMER bit. It is set by the MCP and 
it never changes- It causes GISM0O to issue a dispatch to the 
channei at each 10090 millisecond timer interval and is used toa 
implement TEST.ANDeWAIT operations on tape and disk controis. 
This is discussed in more detait tater. 


The GQVERRIDE bit is used on ati devicas and causes GISM0 to reset 
BUSYs PENDING and EXCEPTION when a new operation is dispatched. 
It is set by the MCPs and reset by GISMO. Essentially» it causes 
GISMO to override an existing operation with a new operatione 


The EXCHANGE bit is set by the MCP and it never changes. It 1s 
used on tape and disk controls only and it means that the 
information in EXCHANGE.»PC is valid» that there is another 
control connected to this controt by a hardware exchange» The 
OLO.MODE bit» also known as the PAUSE bit» is alse set by the MCP 
and never changes. It is set for Single-Line Cortrois and for 
Disk Cartridge Control One. It causes GISM0 to pause for 190 
milliseconds when a tocked descriptor or a Pause I/0 descrioter 
is encountered. [If this bit is nnt set» GISMO wittl stop in this 
circumstance on these controls. 


The INTEGRITY bit is set by the MCP when the channet table entry 
is initialized. It is atlso used by the MCP toa stop GISMO from 
linkimg on the channel. 


The TYPE fieid is used oanty by the Dump Anatyzer program. It is 
necessary because the aénalyzer may have no other means of 
determining this information. The REF.ADDR fieid contains the 
address of the descriptor that is in process on this channel. It 
is considered the head of the queue by GISMO. 


GISMO/HABDWARE INTEREACE 


The I/0 descriptor contains most of the information GISMO needs 
to accomplish an [70 operation. In the actual hardware 
interfaces the OP» BEGIN» ENDe CISK»~ADDRESS and ACTUAL.~END fieids 
are used. The ACTUAL.END field is twenty-four bits in tength and 
immediately preceeds the RS fieid in each descriptor. It #5 not 
shown in the preceding I/0 descriptor diagram. The fieto-is used 
by GISMO while the operation is in process to store the memory 
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address of the data that is to be transferred to or frem the 
memory buffer. When the operation is compietear ACTUALSENS witli 
contain the address of the next bit that data would have been 
transferred to or from. 


Each control is able to buffer» or stores a certain amount of 
data to be transferred. The amount varies among the devices. 
For some devices» such as the card reader and tine printer» it 15 
a full record. For others» the size of the buffer may vary and 


each contol may contain a portion of the data. Disk cortrotse 
for exanpler are equipped with a certain number of l80-byte 
hardware buffers. The amount of data that may be contained in 


the controis and the procedures that GISMO must fottow in the 
execution of an operation are fixed when the controi is designed 
and do not change afterward. 


CAZRE CYCLES 


The hardware in the processor that is used by GIS580 is the 


Command Register» the Data Register and the Service Request 
levei. The Command Register is used to send information to a 
controi-s the Data Register to receive from the control and the 


Service Request tevet indicates that a controt needs attention 
from GISMC. 


Most transactions with the controid consist of a 
Command@=Activate/ResponseComplete CCA/RCO) cycle. Data er 
command information 35 sent out to a controt with a CA. Contras 


information or data is returned with a RC. 


PROCESSOR 270 INSTRUCTIONS 
The processor instructions whch GISHO0 uses to accomptish an 
operation ares 
TEST STATUS 
GISMO requests and the controtl returns its current status 
count and the device ID. GIS5M0 uses this information to 
decide what to do next. 
TEST & CLEAR 
This operation clears the controt. 


TEST SERVICE REQUEST 


GISMNQ requestss and the processor returnse amask of adl 
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channeis that are currently requesting service. 
TERMINATE OATA 


This operator is used to terminate data transfer when tha 
media» disk and tape for eaxampie»r has no fixed record sizes 


TRANSFER OUT A 


Moves one or two bytes of data from memory to the contro¢ 
for output to the device. Data is sent at CA time? th: 
control returns its status at RC time. 


TRANSFER QUT 8B 


Moves three bytes of data from memory to the controt for 
output to the device. 


TRANSFER IN 


Moves one» two or three oOytes of data from the control ta 
main memory on input operations. The deta is sent at RC 
times. When one or two bytes is transferreds the contrat 
aiso sends its status. 


SERVICE REGUEST 


The Service Request Level is a toggle in the processor which is 
settable by any control. It is OR"ed into the "Any Interrupt” 
toggle. Each Interpreter» prior to executing an S"oeratore witht 
test the Any Interrupt toggle ands if it is set» transfer contrei 
to GISMO instead. GISM0O wiit determine what caused the toggle to 
be sate In this case» it wild discover that Service Request is 
raised. 


It witd then do a TEST SERVICE REQUEST CA/RC cycle. The RC witt 
return a mask of all controls that arte currently requesting 
service. GISMO wilt select the highest channet from this mask 
and begin handding that control. Conrots are usuadty in status 
count 41 or 18 when they raise Service Request. This status 
indicates that the control is ready to send a Reference Address 
to GiISMO. GI5M0 acceots the Reference Address and uses it to 
locate I/0 descriptor in memory. 


GISM0 widd then do a TEST STATUS CA/RCO cycle to detemine what 
service the control is requestings.. Once the requested service 
has been performed» and tne control no tonger is requesting 
services GISMO wilt again perform a TEST SERVICE REQUEST CA/RC 
cycle. It wilt continue handling Service Requests from various 
controis until the TEST SERVICE REQUEST returns ati zeros» GI5MN0 
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then returns control to the Interpreter that was interrupted. 


Stars CouaTs 


The Status Count returned by a controt is the primary means in 
which GISM0O determines what is to be done next iin an 1/0 
operation. Qperations may consist of sending the Qp cede and 
file address» sending the Reference Address» receiving the 
Reference Address» sending or receiving data and receivirg the 
result. Various controls perform these steps in different 
orders. 


Adi controls begin in Status Count 1 and return to Status Count 1 
after Status Count 23. Each Status value has a particuiar 
meanings Some counts always appear in series together. Adt 
controls begin an operation by going through Status Courts 1 
through be A simptified table of the attowable ‘Status Count 
transitions is shown in the table betow. 


To send each of the twenty-four bit. fietds OP» DISK~ADDRESS and 
Reference Address» three TRANSFER GUT operations are used» each 
CA/RC sending one byte For each TRANSFER OUT» the Status 
Counter advances by ones Simjdartlysr ta receive either the Result 
Descriptor or the Reference Address» three TRANSFER IN operations 
are used» each CA/RO receiving ona byte. 
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od 
Status Count Meaning 
y) Control Not Present 
1 Cleared Cinitiatl) State 
Ll» 2» 3 Ready to Receive OP» Bytes i» 2 and 3 
he S» 6 Ready to Receive DISK ABORESS» Bytes 1» 2s 3 
7s Bs 3 Ready to Receive Reference Address» Bytas le Ze §$ 
19 Busy COperation in process). From 19» Controis 
usuaiiy go to Status 11 or 13 and raise 
Service Request. 
_ 
tis LZ» 13 Ready to Send Reference Address» Bytes i» 2» 3. 
14 Ready to Receive Data Coutput) 
15 Ready to Send Data Cinput) 
16 End of Hardware @uffer - Ready to Send of Recaive 


Last Byte. More Suffers Remain. 
17 End of Hardware Suffer and Last Buffer. — 


135 13» 20 . Ready to Send Reference Address» Bytes Lv» Ze 3. 
Impiies that a Result Descriptor is to Fottou. 


2i»s 229 23 Ready to Send Rasudt Descriptors Bytes is 2» 3. 


Table Xe-X = Typicat Control Status Counts and their Mearing 
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DATA TRANSEERS 


GISMO transfers data to and from the controt in one or more 
iterations? each iteration will involve onty one control buffer. 
For some devices» there is oanty one buffer and this buffer wiil 
always contain the full physical record. GISMO will only perfora 
data transfer once per I/0 operation for these controis. Other 
controls have physical records of undefined tength> for these 
controls» there are usuaity multipite buffers of fixad length in 
the controt and each iteration of GISMO wilt fill or eamoty one of 
these buffers. 


Whenever Service Request is raised and GISM0 is invoked» the 
requesting control witdi first send the reference address. GISMg 
widd then test the controi"’s status» If the control is in Status 
14 of 15» GISMO will begin data transfer. For each operation» 
data transfer wild continue untid either the control's suffer is 
empty or the END address of the I/0 descriptor is reached. In 
the first case» the controt wild havea gone to Status 7 after the 
last data character(s). GISMO wild test its status» see that it 
is in 35tatus 7 and send it the Reference Addresses thus compteting 
the iteration. In the tatter caser on most controiss GISMO will 
send it a TERMINATE command. Some controis require data transfer 
to continue untid the end of the controt*s buffer. On input» 
GISMO widd accept the remaining data from these controts but will 
not store it in memory. Gn output GISNG witdt send blanks to 
these controls. 


Data is always transferred to a control in ones two or three byte 
portions. Most "Seriat"” devices» such as printers and card 
devices» use one byte transfers. This data transfer is performed 
from a 4oop within GiSH90 which consists of a CA/RC cycter 
transferring one data byte» until the controt{*s buffer is full or 
the END address is reached. A buffer full condition is detected 
by the controt sending or receiving the Last data byte in Status 
Count 16 or if. 


Many disk and tape controts transfer data two bytes per CA/RC. 
Disk input and output is always terminated by GISMO when the END 
address is reacheds possibly in the tast of multipte disk 
sectors. When the record length is an odd numbers GismG wilt 
normalize the Last byte gs required. On output operations» the 
controd wiiit pad the resaainder of the tast buffer Cand hence 
sector) with zeros. 


Tape outpute possibly in the tast of muitipte buffers» is also 
terminated by GISMO when the END address is reached. When the 
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physical record size is an odd number of characters» GISMO will 
rormalize the last byte for the last CA/RE cycle. It will send a 
TERMINATE command» followed by a special command which wiit 
indicate "odd character count” to teli the control that the fast 
data transfer consisted of one byte ondty. Tape input coperations 
wili terminate either when the END address is reached or when the 
end of the physical record is encountered» which may be in the 
last of muitiple buffers. If the end of the physicat record 
occurs and the tength of the record is an odd nuaber of 
characters» the control witd set a flag in the RC portion of the 
last CA/RC cycle. GISMO wild then normalize the last byte of the 
record. 


ALL disk pack controds» the SN head-perwtrack control and att 
Phase~encoded tape controls use three byte data transfers. In 
this case onlyer an exception is made to the general rule that alt 
transactions invotve one CA and one RC. On these controls» one 
CA may be folfowed. by one or more RCs. This is accomplished as 
fodldows. 


Prior to entering the transfer toope on inputer GiSMO will use a 
special CA/RC cycie to ask the control how mdny butes it has ta 
send. It wilt then initiate the transfer toop with a CA and 
continue it with as many RCs as are required» receiving 
twenty-four bits of data on each RC» For output» GISMO wild tet 
the control how many bytes it has to sends it wild then initiates 
the transfer toop with a CA command of TRANSFER OUT Bs and 
continua it with as many RCs as are requireds sending the data 
Out with the RC. 


G70 CHAINING 


The I1/0 subsystem of the 31000 system does not use queues for [7/9 
operations. Using the facilities presented in the oprecading» it 
connects aii I/0 descriptors that are directed to the sare 
control» or group of controls connected by an exchanges inoa 
circular chains. This eliminates the necessity of an I/9 comptete 
interrupt being directed to the MCP» provided the producer of [70 
requests» most often a user programe does not produce the 
requests faster than they can be satisfied. In other words» if 
the I/70 subsystem is completing operations before they are 
actual4y required by the user» then the user wiit never need toa 
Wait on the completion of an 1/0 request and the MCP will never 
have to suspend the program waiting for such a corpletion. 


Even if this tsn*t the case» if the user program its forced toa 
Wait upon the completion of his 170 requests» the amount of 
processing that must be done to accomplish the suspension and to 
reinstate the pfogram upon completion is minimized using 
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chaininge The processing is tlimited to only that which is 


concerned with program execution and no processing is required to 
teil the I/70 subsystem what it should do next. This information 
is atready contained in the 1/0 descriptor. 


For alt devices except tape and disk» thense the MCP constructs 3 
circular chain of descriptors in memory. GI3MQ executes the 
requested operations in turne as each descriptor is untocked by 
the MCP. Upon encountering a tocked descriptor» GISMO simpty 
pauses or stops unti4 the descriptor is untocked. This wilt 
occur when the user program next executes an I/0 request or when 
the file is closed for any reason. if the prograr must wait upon 
an operations an I[/0 comptete interrupt is requested» using the 
appropriate bit in the RS fieids and the program is suspended 
pending the occurrence of the interrupt. 


DISK 120 CHAINING 


The dist [/0 subsystem operates somewhat differently from the 
operation just described. Since each disk I/0 descriptor 
contains a disk address fieid» it 36 not =necesary for the 
operations to execute in any particular order. ‘Various @eans are 
provided in the software to prevent any contention problems that 
might arise. It may be noted that these same @eans are necessary 
on I/0 subsystems which utilize queusing instead of chaining. 


Adi I/0 descriptors for ali disk controls that are connected to 
the system are connected in the same chain. Lf the system i4 
equipped with more than one controt» then each Channet fTfabte 
entry will point to the head of the chains If GISHO encounters a 
descriptor which is not ready for execution or which is siready 
in process» specified by the first two bits of the RS Fietd being 
set to anything other than 00» it does not stop or pause but 


continues to the next descriptor in the chain. Atsor» if an 
exception condition occurs» GiISMD does not stop or pause as it 
does on other controtse Both of these actions are specified by 


the CHANNEL~NO.HALT bit in the Channet Table. 


Since GISMO continues finking in doth of the cases meartioned 


aboves it must know when it has examined alt of the descriptors 
in the chains when it has axamined ali of the descriptors» it 
must stop to free the processor for other executione To 


accomplish this» the REF.ADOR field in the Channat Table is used 
to mark the beginning of the chains When a disk operation is 
dispatched by the MCP» the reference address passed by the 
dispatch is discarded and the REF.»ADODR field is used instead. 
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In order to operate properly with dispatch operations occurring 
jin an order different from the order of the descriptor tink 
fields» GISMO must be able to override stopping when it has been 
through the entire chain once» For examples if descriptors A» 8» 
and € are oresent in the chain and if B is dispatched» GISMO will 
link to and initiate 8B. if» during the time that 8 is in 
process» A is dispatched» GISM3 must Link past C and the REF e.ADODR 
field and find and initiate A. 


To accomplish this» the PENDING bit in the Channei Tadte is used. 
This bit is set by a dispatch operation and reset by GISNO. If 
GI3M0 arrives at the descriptor addressed by the REF.-ADDR fieid 
and if the PENDING bit i185 set» it does not stop but resets 
PENDING and continues tinking. If PENDING is already reset at 
this pointe then GISHO stops. ; 


Since aid descriptors for ali disk controis are maintained in tha 
same chains GISMO must be able to recognize descriptors which area 
addressed to controts different from the one it is handling. 
This is accomplished using the [O.CHANNEL.RS field of the I/9 
descriptor. Upon encountering an unlocked 1/70 descriptors GiISD 
compares this field to the channel Gt is executing upon and if 
the two are not equate it does not mark the descriptor in grocess 
but continues Linking. 


DISK i20 QONERLAPPEO SEEKS 


When an I[/0 operation is initiated on a moveabite arm disk device 
and the arm ais presently positioned to a cylinder different fron 
the one specified in the dascriptors it is necessary to 
reposition the arm to the proper cylinder. This operation is 
known as a “seek™. On the 81009 system» ali seek operations area 
impiicit? there is no explicit Seek operation in the hardware. 
The MCPs initiate disk I79 operations without regard for the 
current arm position and» if ars movement is requiredr it is 
accomplished by GISMOs the control and the device without the 
MCPs participation. The MCP does not know that a seek is Being 
performed or required. 


On this systems» ali seek operations are “overlapped”. This means 
that the arm of any given drive may be in motion sinultaneousty 
with the arm of any other drives). Atso» thea controt may ba 
performing data transfer or any other operation while the armas 
are in notions . 


This #8 accomplished by the control returning a resuit descriptor 
with Bit 1?» IQsRESULT.SIT~17» set to zero. Esssentiaity» this 
informs GISMO that some special action is necessary and that 
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GISMG should not store the result descriptor in memory. In this 
particudar case» the controt atso informs GI5M0 that the selected 
drive is non seeking. GISMOG widd initiate no further operations 


upon that drive until informed» by the hardware» that the seek 
ooeration has completed. . 


OCC-2 (Cartridge) and all disk pack controis notify GIS#G that a 
seek operation has compieted by raising Service Request while ir 
Status Count 1. GISMO will again send the descriptor to the 
controt and this time» efter any required tatency period» data 
transfer witli occur. DCC-1 does not notify GISMO when a seek 
operation has compdeted but must be "“"polied”™ periodicatty by 
GISM0. The pause time period for DCC-1» the time between the 
poli operations» is two milliseconds. 


The Disk Subsystem Controtier (050) offerred on GEM processors 
introduces some exceptions to the statements above» These 
exceptions witdl be defined in a subsequent version of tha 
specification. 


JAPE 120 SHAINING 


The chaining of I/0 descriptors for magnetic tape controis is 
perhaps the most comptex of the three basic types. The 
complexity is caused by the fact that tape I/0 descriptors 
directed to each separate tape unit must be executed in togicat 
sequence and there may be several such units attached to the same 
controi(ts). It doesn't matter which unit GISMO addresses next 
but the descriptor that is used to address the unit must be the 
next logical descriptor in the “subchain” for that unit. It is 
therefore necessary to oreak the channel chain into subchains» 
with one subchain for each physical unit» and to imptesent 3 a 
means of remembering the next logicat descriptor that must be 
used within each subchain. 


Both of these requirements are satisfied by the Lock descriptor. 
Lock is a pseudo I1/0 operation which is handled completely by 
GISMO and actually causes no physical I/G operations. It also 
serves as a aeans of resolving contention problems batweer the 
MCPs and GISMO and between two or more tapa controls which are 
attached to the same units by an exchanges Lock operates as 
described below. 


The MCP» when the system is Clear/Started>» constructs 4 tape 
chain with one Lock descriptor for each unit connected to the 
system. The ACTUAL.END fietd of a Lock descriptor is not used 
and the LINK fietld widl contain the memory address of the next 
Lock descriptor. Tne BEGIN and END address fields of the Lock 
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descriptor wiii contain the address of the TEST.~AND.WAIT [73 
descriptor that the MCP uses to monitor the status of each unit. 
This 38 discussed in a later paragraph. 


When a file is opened on a tape unit» the MCP changes the BEGIN 
and END address fields in the Lock descriptor. The MCP now 
constructs a subchain for the unit which will consist of one [7/3 
descriptor for each buffer requested by the user. The BECIN and 
END addresses of the Lock dascriptor will be set to the memory 
address of the first physical I/70 descriptor in the subchain and 
the TEST»~AND»~WAIT descriptor will be removed from the subchain. 
The BEGIN address field will not be altered from this poirt until 
the fite ts Closed. The END address witli be wodified by GISd 
each time it executes an operation in the subchain. In effect» 
The END address field is used to remember the next togicat 
operation that is to be performed on the unit. 


The LINK fields in each I70 descriptor in the subchain wilt att 
address the next physical descriptor in the subchaine as they do 
for ali other contrats. An axception to this is the tast 
physicait descriptor in the subchain. The LINK field of this 
descriptor will contain the address of the Lock descriptor (for 
that unit. This prevent one unit from monopolizing the entire 
control? it insures that GISM0 widd periodically determine if 
there is anything to be done on the other units. 


The REF.ADGR fieid of the Channed Table entry for a tape chain 
will contain the address of the first Lock descriptor in the 
chain. Gismor upon receiving a Dispatch for a tape controt» wilt 
discard the Reference Address passsed and start at the address 
provided by the REF.ADDR fieid. GISMD first attempts to lock the 
Lock descriptor by swapping O01 into the first two bits of the RS 
field. If successfut» it fetches the address in the END field of 
the Lock descriptor and proceeds to that address. If this 
descriptor is untocked» it begins the operation snecified. Tf 
not» it returns to the Leck descriptor and stores the address» 
which it previousdy fetched from the END address fieid back into 
the END address field. 


Assume now that the descriptor at the address fetched from the 
END field of the Lock descriptor was unlocked.» GI5N40 begins this 
operation andes assuming that the operation cannot be compieted 
without some intermediate Service Requests» returns to the Lock 
descriptor and continues dinking through the chain. Eventuatt y» 
the controi widdi raise Service Request and reference tha 
initiated descriptor. Upon comatletion of that descriptor» GI3J 
widd store aresult and fetch the LINK field of the descriptor. 
It witt then proceed to the new descriptor and again check to see 
if it is tocked. If it ise GISMD returns to the Lock descriptor 
for the unit and stores the new address in the END address field. 
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The new descriptor now becomes the next dogical descriptor to bea 
executed on that unit. In this mannere GISmO effectively 
maintains a dogicad sequenca of operations that are to be 
performed on any tape unite 


It may be noticed from the foregoing that there is no possibility 
of conflict for a unit between two or more controis connected by 
an exchanger since GI53M0 first attemots to tock the Lock 
descriptor before proceeding doun a subchain. Similarly» the ACP 
Must tock the subchain before altering any descriptor in the 
subchain. 


MONITORING OF PERIPHERAL STATUS 


The MCP attempts to monitor the status of aii perioherat devices 


that are attached to the system. To do this» it must rememder 
the status of each device and maintain a certain apount of 
information about each. The major portion of the information 


about aai of the devices connected is maintained in the I/3 
Assignment Table CIOGAT). 


420 ASSIGNMENT TABLE 


The I70 Assignment Table CIOAT) aldows the MCP to keep track of 
aii peripherat units except the system's SPO and those devices 
associated with data communication. éEach unit is identified by 
port» channed» and unit numbers as wedd as by a symbotic name. 
Various fieids reflect the status of the unit Ceegee AVAILABLE> 
SAVED» REWINDINGe LOCKED}. A programmatic description is given 
betow: 


DEFINE IGATW.STZE AS #85128; 


DEFINE IDAT»~DECLARATION AS # 2Gt QO BAL IQA T 
DECLARE 1 DUMMY REMAPS IGAT» 
02 UNIT.»INITIAL BIT (66)> 2% 
a3 UNIT .HDWR BIT €8)» 
03 UNIT .PCD BIT (i2)> % 
94 UNIT.~PORT.~jCHANNEL BIT C7)» &% 
05 UNIT.»PURT BIT C3)» & 
O35 UNIT.~CHANNEL BIT C4)» & 
04 FILLER BOOLEAN» & 
04 UNITUNIT BIT (43> 2 
03 UNIT »NAME CHAR (6) 
02 UNTT»LABEL~ADDRESS DSK »ADR» 
03 FILLER BIT (12)» 
93 UNIT.~PACK. INFO ADDRESS» 
02 UNIT TRS ADDRESS»% USER LINIT REGISTER 


o2 UNIT.FLAGS BITC36)» 
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93 UNIT sAVAIL ABLE BOOLEAN» 

03 UNTT.AVAILA3LE «INPUT BS00LEAN» 

03 UNIT.AVAIL ABLE OUTPUT BOOLEAN» 

03 UNITWAIT»FOR»NOT»~READY  S800LEAN>» 

03 UNIT.TEST.AND. WAIT BOOLEAN» 

O3 UNIT .SAVED BOOLEAN» 

03 UNIT.REWINDING BOOLEAN» 

03 UNIT EOF »SENSED BOOLEAN» 

03 UNIT.»LOCKED BOOLEAN» 

03 UNIT.»LASEL»SENSED BOOLEAN» 

03 UNIT.»PRINT.»BACKUP BOOLEAN» 

93 UN TT .PURGE BOOLEAN» 

03 UNET.~LOCKsATsTERM BOOLEAN» 

93 UNTT~TO-BE SAVED BOOLEAN» 

03 UNIT .FLUSH BOOLEAN»% FLUSH TO EOF 

03 UNIT»TAPECF BOOLEAN» 

93 UNIT .DEISKF BOOLEAN» 

03 UNIT .STOPPED BOOLEAN» 

03 UNITT.TRANSLATE BOOLEAN» 

03 UNIT .CTRL»CARD USING BOOLEAN» & 

03 UNIT.~REMOTE.J98 BOOLEAN» 

03 UNIT.CLGSED BOOLEAN» & 

03 UNIT»CLEARED BOOLEAN» 

O35 UNIT»MULTI.FILE BOOLEAN» 2 

03 UNIT.EOT BOOLEAN» 

03 UNIT.~TAPE~FILE»STATUS BITC3)9% G = NOT RELEVANTC_ANST) 
% 1 = GOVCBEG OF VULUNE 
% 2 = BOFCBEC OF FILE) 
% 3 = EQVCEND UF VOLUME) 
Z 4 = EQFCENC OF FILE) 
2 5 = PFBCPROCESS FILE BLK 
4 * = UNDEFINED 


O03 UNIT~TAPE.XCH BOOLEAN»% FOR MIS*MATCHED UNITS 
O03 UNIT.NG.TRANS»TSLE BOOLEAN? 2PC“5 
03 UNTT.OFFLINE~}YET»TNeUSE BOOLEANsZFOR ASSIGNED UNITS. 


03  UNIT.AUDIT BOOLEAN» % ONS AUDIT TAPE 

03 UNIT.RESERVED.BY.AB BODLEAN>% AUTO BACKUP 6.1 

03 UNIT»LABEL.OP BIT(3)»% O=3IOOEOOXS ODD TRANS 
%-1=2900C09X2 ODD NO TRANS 
% 2=900600Xa EVEN TRANS 


% 3=d290400Ka EVEN NO TRANS 


02 UNTT»DRIVE»TYPE BITC4)»% DISK ONLY 
% WALUE ocCiv2/73 .OPCiv2 OFC DFCS 
a 0 532X293 ONZA N/A N/A 
a 1 532X406 215 S¥SeMcCM SN 
Fs 2 64X203 225 N/A N/A 
% 3 654X490 NJ A iC=3 NJ A 
r4 4 N/A 297 1C-4 N/A ae 
A 3 N/A 205 LA~3 NJ A 
a 6 N/A 296 LA=4 N/A 
a r N/A N/A NJA N/A 

v2 UNIT.» STATUS BIT €15)» 

02 UNTT.~TO.3f-POWERED. OFF BOOLEAN» 

02 FILLER BIiT{? }» 
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02 UNITT.J03.NUMBER BITC 16)» 
02 UNIT.~FIs.ADDRESS ADDRESS>» 
02 UNITsLASEL»TYPE BIT (2)>» 
% 0 = OMITTED 
% 1 = BURROUGHS 
* 2 = USAST 
4 3 = INSTALLATION 
02 UNIT.» TRANS» T3LE.19 BIT(Bd» &PC"5 TRAIN ID 
02 FILLER WORD»% PLEASE DO NOT OLSTURE 
02 UNTT~TEST.~ODESC BIT CDESCRIPTOR~SIZE)> 
a> x DELIMIT raat DEF INE 


The entire IDAT is constructed by the MCP when the system is 
Clear/Started. Ouring the Clear/Start operations the MCP directs 
a Test descriptor to each of the controts that are connected to 
the system. When it discovers a control that may have more than 
one unit connected to it» it sends a Test descriptor to each 
possibile unit and makes one entry in the IQAT for each unit that 
is connected. 


Thea UMEIT.HDWR fieid in the [GAT will contain the hardware 
identifier returned by the test descriptor. The fotlowirg is a2 
list of hardware types and psaeudo~types that are supported by the 
MCP. Pseudo-types are used in the device assignment process to 
indicate generic types» such as "any Magnetic tape device” which 
would incitude sevenwtrack»s ninecttrack» phase encoded» NRZ and so 
forth. 
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DEVICE 
Reserved 
80 cot READER»PUNCH. PRINTER 
80 cot CARD PUNCH 
Reserved 
FDC.1 
96 cot READER PUNCH PRINTER 
PAPER TAPE READER 
PAPER TAPE READER-i 
PRINTER 
READER SORTER<-2 
READER SORTER . 
DISK FILE CAny head per track) 
DF C-i . 
pec@-2 
DCC-i 
BPC=-1 
DESK PACK C€OCC$L» BCC“2» OPC$-1) 
DISK CAny disk) 
DF C3 (5=N) 
96 col READER 
PAPER TAPE PUNCH 
89 cot CARD READER 
SPO-1 
SP0-2 
JAPE 9 TRK NRZ 
TAPE 7 TRK NRZ 
TAPE PE (9 TRK) 
TAPE CAny taped 
TAPE .9 CAny 9 TRK tape) 
Reserved 
CASSETTE 
LPC=5 
QUEUE FILE 
REMOTE FILE 
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FILE STMT HOWR TYPE 

00 
DATA»RECORDER.80 O1 
CARD.»PUNCH 02 

03 

04 
RE ADER»PUNCH»PRINTER 05 
PAPER. TAPE .READER 06 
~PAPER.TAPE READER O7 
PRINTER 08 
READERSORTER.2 09 
READER.SORTER 10 
DISM.FILE 11 
DISK -FILE.1 12 
DISK «CARTRIDGE 13 
DISK .»CARTRICGE i4 
DISK»PACK.10 i5 
DISK.~PACK 16 
DISK 17 
DISK»FILE.3 13 
READER.96 19 
PAPER.sTAPE «PUNCH 20 
CARDREADER 21 

22 
CRT SPO 23 
TAPE.9 24 
TAPE.7 25 
TAPE.PE 26 
TAPE of 
TAPE. 23 

29 
CASSETTE 39 
PC .5 314 
QUEUE 62 
REMOTE 43 


Table 3.x = Hardware types supported by MCP 
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In the table above»r the File Statement column CFILE STHT) is for 
use in the MNCP%s FILE Controt Card and is explained in the 
software Operational Guide. Generic hardware type numbers are 
not stored in the IDAT. Rather» the actual identifiers returned 
by the hardware are used. 


UNIT MNEMONIES 


Unit mnemonics are atiso assigned by the MCP during thea 
Cilear/Start process. These mnemonics adiow the operator and the 
MCP to identify devices uniquely.» Tha tabte below tists the for 
ef the nemonic that will be assigned to the various types of 
devices. 


Card Reader CRx 
Card Punch CPx 
Data Recordars CDx 
Printers LPx 
Tape Units MTx 
Disk <Chead-oer-track) none 
Disk Pack OP x 
Disk Cartridge DCx 
Paper Tape Readers PRx 
Paper Tapa Punches PP x 
Reader-Sorters RS*x 
Cassettes csx 
Flexi -Dask FDx 


All units will be assigned 4a threeccharacter anemonic which 
begins with the first twe letters listed in the table above. The 


third character wiitl be unique to the unit. The first unit of 
that type encountered by the MCP during the Clear/Start operation 
is assigned the tetter "A™>» the second "8" and so forth. 


Assignment oroceeds aiphabeticalty and the mnemonic assigned does 
not change uniess the system configuration changes. 


‘ 


The assigned unit mnemonic is stored in the IGAT in the UNIT.NAME 
fieid. The entire IGAT is maintained in seaory. To minimize 
storage requirements» some information which relates to the unit 
is not stored in the IAT but is maintained on disk. File 
Identifiers and any other information which is seidom used by the 
MCP are stored in an INTERNAL.~LABEL field on disk. The disk 
address of this field is maintained in the [DAT in the 
UNIT.LABEL ADDRESS fieid. Information in this field is typicaily 
updated by the STATUS procedure in the MCP. 


The STATUS procedure is executed whenever the Ready status of an 
unassigned device changes» The MCP 48s made gware of a status 
change by TEST.AND~WAIT I/G operators. These operators do nat 


3°23 


BURROUGHS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP BLoo0oO MCP {i 
SANTA BARBARA PLANT P.S. 2212 5462 (E) 


truly wait on aunit status change but this function fs emulated 
by GI5M0. 


TESTsANDsWATT 120 QPERATORS 


The MCP must know when a unit goes from a Not Ready condition to 
a Ready condition so that it can read the Label on the media and 
update the INTERNAL.~LABEL information on diske- It must know whan 
a unit changes from Ready to Not Ready so that it can mark the 
unit unavailable and initiate a TEST.AND~WALT.~FOR.READY on the 
unit. TEST#AND~WAIT operations allow the specificatior of 
certain conditions for completion» such as Test and Wait §=“for 
Readyr Not Ready» Ready to Transmite»y Ready to Receive and go 
forth. GISMO widd not consider the operation complete unless the 
specified conditions are met. 


Gn disk and tape controts» which allow more than one unit per 
controis»s we cannot tie up the entire controt with a Test and Wait 
operation to one unit. For OCC*2» ati disk pack and ail tane 
controls» the PAUSE bit in the Channel Table is used to implement 
a periodic test of ald such units. At each 190 mittisecond timer 
intervals» GI5M0 searches through the Channel Table tocking for 
entries with this bit set to zaro., When such an entry is found» 
GISMG initiates that chain at the address specified by REF.ADDR- 
aiso in the Channel fTabte. During this execution» GISS8O witi 
initiate aii Test operations encountered in the chains If the 
conditions for compietion specified in the operator have been 
meats GISNO witf store ths result descriptor reaturned by the 
operation and queue an interrupt for the MCP? the MCP atways 
requests an interrupt in Test and Wait descriptors. 


The MCP also sets the type fietd of this I/0 descriptor» 
ID.MCP.I1CG» to a value which indicates “Status Change”. In the 
MCP*s [7/0 Compdete procedures which 48 j%$invoked onty shen an 
Interrupt is returned from an [70 operatione the value stored in 
I0.MCP.10 witt cause invocation of the MCP"s STATUS Procedire. 


STATUS PROCEDURE 


As mentioned previoustys the STATUS Procedure is executed aonty 
when the status of an unassigned peripheral changes. If a 
peripheratl is being used by 2 program and if it goes to a Nat 
Ready canditions the situation is handted by the I70 Error 
Procedure. When an assigned peripheral goes from Not Ready to 
Read yr no action is required by the MCP since the Test and Wait 
descriptor executed in this case wiil have a LINK field set ta 
the next togicat operation to be nerformed on the device. 
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Peripherat devices which are capabdts of input operations usuatty 
have tabels written on the media. The MCP is enquirgpred to 
recognize several different tabet formats on disk and tape 
devices and it expects to read controi instructions from ali card 
devices which have input capabilities. Controt instructions ar2 
discussed in the Software Qperational Guide and in Product 
Specification 2219 O44» MCP Controt Syntax and will not be 
discussed here. Essentiadiy»s when a card device becomes Ready 
for input purposes» the Status Procedure reads the first card ang 
control is passed to the Controt Card Procedure. 


Qn disk and tape devicesrs when a unit becomes Ready» the Status 
Procedure attemots to read a dabel from the mediae The fottowing 
is a description of the various tabei formats» oan disk and tane 
devices» the MCP is capable of recognizing. 


DISK IDENTIFICATION = PACK LABELS 


Every disk pack» disk cartridge» or head“per-track subsystem 15 


identified by a standard "ANSI" pack tabel. This pack tabet- 
written in EBCDIC (8 bit code)» is two pack sectors dong (360 
bytes)» and occupies the first two sectors on a pack» TeEor 


cylinder 0» track 0» sectors 9 and 1. Sector 0 contains pack 
identification information and sector 1 is reserved for future 
implementation of pack security procedures. A programmatic 
description is given betow: 


DEFINE PACK.LABEL»DECLARATIGN AS #2 
DECLARE O1 DUMMY REMAPS PACK.LADELS 


° O02 PL»¥OL1 CHAR (4) & "VOLi" 
, O02 PL»SERTAL.NO CHAR (6) & SERTAL (CAN) NUMBER 
» 02 PL»ACCESS.CODE CHAR C1) & ACCESS Code 
» O02 PL.~ID CHAR C17) &% PATK 19 
» 03 PL»NAME CHAR €10) & 
, O03 FILLER CHAR (7) 2% 
» O2 PLeSYSTEMAINTERCHANGE CHAR (2) & SYSTEM INTERCHANGE/SCOOE 
. 2 O00 = INTERCHANGE 
*% 417 = 81600 INTERNAL 
% 35 = 93500 INTERNAL 
~Z ECs ETC» ETC 
> O02 PL.CODE CHAR €1) & PACK CODE O09 = SCRATCH 
» O02 FILLER CHAR (6) 1% 
° O02 PL.~OWNER.ID CHAR Ti4) & 
? 02 PL.~TYPE CHAR (1) 2% "Rw = RESTRICTED PACK. 
% "UYU" = USER PACK ; 
% "S" = SYSTEM.PACK 
? 02 PL~CONTINUE CHAR (1) 2% CONTINUATION FLAG “C™ 
, 02 FILLER CHAR £26) & 
, 02 PL~INT CHAR €21) & 
» O02 PL.~VOQL2 CHAR (4) & bole a ers 
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, O02 PL»aDATEs*INITIALIZED CHAR (5) & 
, O2 PLeINITSYSTEM CHAR (6) 2& INITIALIZING SYSTEM 
» O2 PLeDISK.»DIRECTORY CHAR (8) & DIRECTORY ADDRESS 
» O02 PL»MASTER.AVAIL CHAR (8) & MASTER AVAILABLE TABLE 
’ O02 PL»~DISK AVAILABLE CHAR (8) & WORKING AWAILABLE TAQSLE 
, 02 PL»~INTEGRITY CHAR (1) 2 0 = NORMAL 
x 1 = RECOVERY REQUIRED 
» O02 PL~ERROR.~CIUNT CHAR (6) & 
, 02 PL.~SECTORS~jXD CHAR (6) & REMOVED SECTORS 
, O2 PL» TEMP TABLE CHAR (8) 2% TEMP TABLE LINK 
» O02 PL.PCD CHAR €3) % LAST PORTs CHAN» DRIVE 
? O02 PL»aASSIGNED~TOBPS CHAR (6) & BASE PACK SERTAL NUMBER 


In the case of disk devices» additional inforsation»s beyond that 
which can be stored in the IOAT» is required by the SCP for 
proper operation. The STATUS Procedure and others matntain this 
information in a reserved area in memory known as the Pack 
Information Tabte (PACK.INFO). 


PACK INFORMATION TABLE 


The pack information table is an MCP maintained tinked dist of 
all user disk packs and cartridges currentiy on Line. Tt 
contains such information as the namee serial numbers hardware 
unit» number of userse and addresses of the disk directory» 
available tabie» and temoorary tabie. This structure alttows a 
pack or cartridge to be externatty referenced by nage. A 
programmatic description i3s given below: 


DEFINE PACK~INFOs»DECLARATION AS #2 
DECLARE OL DUMMY REMAPS PACK.INF DO» 


02 P.NAME NAME> 
02 P»SERTAL.NO WORD» 
O02 P.DISK»*DIRECTORY DSK»ADR» 
O02 P.DISK»~AVATLABLE — DSKAADR» 
G2 P.TEMP.TABLE DSK »ADR» 
02 PsUNIT.NAME CHAR (6)>» 
02 P»PCD BIT €12)>» 
O03 Pe»ePORT»CHKAN BIT €7)» 
03 FILLER BIT (€1)>» 
03 P»eDRIVE.NO BIT €4)>» 
O02 PeNGeUSERS BIT €8)>» 
02 PeNG»aMPF.AUSERS BIT (8)-> 
O02 P»TO.BE.POWERED»QOWN BOOLEAN> 
02 PRESTRICTED BIT €3)» % 0 = SYSTEM RESOURCE PACK 
. & 1 = RESTRICTED 
% 2 = UNRESTRICTED USER 
a 3 = INTERCHANGE 
02 PelCONTINUE BOOLEAN» ZX 1 = CONTINUATION PACK 
O2 P.~SCRATCH BOOLEAN» % 1 = SCRATCH PACK 
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02 PeF ULL BOOLEAN» &% 1 = AG NORE AVL DISK 
02 PoXC BOOLEAN» ZPACK HAS UNDERGONE XC. 
02 PeASSIGNED.TO.3PS WORD» % ASSIGNED TD BASE PACK # 
02 P»~BACK.LINK ADORESS» 
02 P.»ALINK ADDRESS» 


tre 
TAPE LABELLING» INITIALIZATION AND PURGING 


MCP Gi ainctudes the capability to create and recognize tno 
different foras of magnetic tape Labels. The standard dabei 
format for the Bi000 system will conform to that specified in tha 
publication entitied “The American Nationat Standard Magnetic 
Tape Labels for Information Exchange* which is dated 1969 and 
published by the American National Standards Institute» Ince 
CANSII)D. These tabets are commonly known as *VANSIETs Version i” 
labels. It should be neted that “standard tabet format” for tha 
system means that any program which requests standard tabels in 
its file deciaration widd cause ANSII labeis to be written when 
the file is assigned to magnetic tape» and the file is opened 
output. Users are aitowed to create the labei in ASCIET if they 
so desire. 


ANSII tabels as implemented on the BiGO0 system contain several 
deviations from the standard as presented by the ANSII documents. 
The deviations are necessary in order to insure that we ar? 
compatible with the 86700 system. The most noteworthy deviation 
is the recording node of the tabel itself; it is written in 
EBCDIC character code uniess ASCII is specificaity requested via 
the "SN" command. 


ANSII label format» as implemented» consists of three fchysical 
biocks on the taper» followed by a tape mark. The first of the 
three blocks is known as the Votume Header. A programmatic 
description is poresented below. 


OL VOLUME.HEADER 


02 FILLER . CHARACTER(4) 
ZAThis field wit! adways contain *VOL1”" 

02 VOLUME.ID | CHARACTERCH) 

O02 ACCESSABILITY CHARACTER 1) 


2tThis fietd is not used by the 81000 
92 RFS This fietd is reserved in the ANSII Standard.» It is 
being used as foilows by the B1000 and the 86700. 

93 MULTI.FILE.10 CHARACTER(17) 
% "0" af there is no FID 
Z "x9" af Scratch 
% "BACKUP™ if Backup 

03 SY¥30e SYMBOL CHARACTER(C23 
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% Will contain "17" if created on B1000 
03 TAPE.TYPE CHARACTERC1L) 
% 9 = Scratch 
4 1 = User 
4% 2 = Backup 
4 3 = Library 
03 FILLER CHARACTER(S) 
02 OWNER.WID CHARACTER(C14) 
% This fietd is not currently usable on the 81000 systen 
02 FILLER CHARACTER(C 28) 
O02 VERSION CHARACTERCL) 
% Wild contain "1" untid such time as the label format. is 
% changed 


The second of the three physical blocks is known as "Header One". 
The format is aiso used for Endwof-File and End-of-Votume. A 
programmatic description is given baton. 


91 HEADERIDECLARATION 


02 FILLER CHARACTER 4) 

% May contain *"HAHRDI*> *EDFi"%» or "EQ VI" 
O2 FILE.IB CHARACTERCi7) 
O02 FILE.-SET.IG CHARACTER(6) 


® This fieid wilt contain the first six characters fron 
2 the MFID field in the VOL1I block 


02 FILE~SECTION.ND CHARACTERC4) 
% Used for Reel number by 86700 and 81000 
02 FILE.~SEO.ND CHARACTER{ 4) 
% Urdinat number of the file within a Muiti-Fite 
02 GENERATION.NG CHARACTERC4) &% Unused 
O2 GENERATION.~VERSTION.NG CHARACTER(2) 2% Unused 
O2 CREATION.DATE CHARACTERC6) % bYYEDD 
O02 EXPIRATION.DATE CHARACTERCLH) ££ bYYDDO 
O2 ACCESSABILITY CHARACTERC1) 2 Unused 
02 BLOCK.~COUNT CHARACTERC6) 
% Zero if this is a Header.Gne block 
O02 SYSTEM~CODE CHARACTERC13) *£ "81700" 
O02 FILLER CHARACTERC?T) 
The third physical block is known a5 "Header Two". It is aaiso 
used at End-of-File and End-of-Volume. Its format is shown 
below? 
91 HEADER2.»DECLARATION 
92 FILLER CHARACTER(CA) 
% May contain "HDR2Z"» “EOF2"» or "EQ¥2" 
02 RECORD.FORMAT CHARACTERCL) 
% F = Fixed 
* WV = VYariabie 
% 3 = Spanned (Not yet implemented by any gurroughs system) 
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x U = Undefined 
02 BLOCK.LENGTH CHARACTER(S) 
O02 RECCROeLENGTH CHARACTER(S) 
02 RESV.SYSTEM.WUSE CHARACTER(C35) 
O03 DENSITY CHARACTERC1) 
% 6 = > 899 
% 1 = > 556 
% 2 = > 200 
% 3 = > 1600 
O3 SENTINAL CHARACTERCI3 Z% Unused 
03 PARITY CHARACTERC1) 
x 0 = Evens 1 = Odd 
O3 EXT»FORM CHARACTER(1L) 
% 09 = Unspecified 
% 1 = Binary 
% 2 = aseiit 
42 3 = BCL 
% 4 = ESCBIC . 
93 FILLER CHARACTERC3L) 
O2 BUFFER.OFFSET CHARACTER(2).% Unused 


2 FILLER CHARACTER( 28) 


As mentioned in a prior paragraph» the MCP writes ANSII Format 
labeds on tapes whenever a fite is opened output and the 
LABEL~TYPE fieid in the FP3 is sat to vero. If the user Kishes 
to continue writing the oid Burroughs format tebetss he must 
modify this field in ati of the files in his programs. This may 
be accomplished by recompidiation» by the use of a File Attribute 
communicate operation within the programs by the use of the 
MODIFY control instruction or by the use of a FILE card when tha 
program as executed. Presently valid vatues for the LABEL.TYFPE 
field ares 


0 = ANSIT 
1 = Untabeitied 
2 = Burroughs 


ANSII Labels» though they are written when the file is opened 
output» are actualdy created on ali magnetic’ tapes prior to that 
time. A keyboard message has been implemented in the MCP for 
purposes of creating the initiat ANSII tabel on atti tapes. The 
mnemonic of the sessage is “SN" which used to be an acronym for 
Serial Nurtber. The syntax for SN is: 


SN <unit mnemonic> <volumetidentifier> & ASCII 3 


“Volume identifier> may consist of one to six aiphanumeric 
characters and is inserted in the VOLUME.ID fietd of the VOLi 
block of the d4dabed which is created. This operation is» for 
conversational purposes» knoun as “*“initializing*™ the tape. Atl 
tapes and cassettes must be initialized on the 81000 before the 
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MCP wilt consider them scratch. Tnrhis applies to seven track» 35 
weil as atd versjons of ninetrack tapes. 


The <volume identifier> keyed in witli remain on the tape until 
the tape is reinitiatized. The tape may be purged at any times 
provided the ANSII tabel is staid intact on the tape. Tapes 
which have Burroughs Labels on them must be rerinitialized and 
may not be purged. Purging» here» impiies the use of the "P&G" 
keyboard message.» Similarity» untabelied tapes may not be purged» 
but may be rewrinitialied. The <volume identifier> is now cart of. 
the output of the "OL" message. Tha presence of the reserved 
word ASCII in an SN statement causes the label to be written in 
ASCII character codese 


The capability of creating and recognizing ANSIIT tabels was not 
incituded in the MCP prior to the 3.0 release of the softwara. 
Before the 5.0 release» ali Labels created by the 81000 system 
were the oid Burroughs tabels first implemented on the 85509 
system. A programmatic descrintion of these tabelsre as they ara 
created on the 891000» is shown below. As can be seen from the 
description» certain fields have been added to the tabeis to 
improve their utility. These fields are meaningful to the 81000 
system oniy» A programmatic description is presented below. 


DEFINE STANDARDeLABEL~DECLARATION AS # % 
DECLARE 01 GUMMY REMAPS LeLABELeRECORD 2% 


» 02 L.LABEL CHAR (9) & " LABEL o* 

» 02 L.NFIO CHAR (7) % " 

» 02 LeZl CHAR (1) ¥ "ge " 

» 02 LID CHAR (7) 2% 

» 02 LaREEL CHAR (3) 2% 

>» 02 L.DW CHAR (5) % DATE WRITTEN 

» O02 LaCYCLE CHAR (2) 2% "9" 

>» 02 L.PIC CHAR (5) 2 PURGE DATE 

» 02 LoS CHAR (1) 4% SENTINNEL C1 = END@QF“REEL) 

> G2 LBC CHAR (5) % BLOCK COUNT 

>» O02 LoRC CHAR (7) % RECORD COUNT 

» 02 LoPB CHAR C41) PRINT BACKUP FLAG 

» 02 L.SERTAL CHAR (5) % SERTAL NUNBER 

» O2 LeSYSTEM | CHAR (5) X% CREATING SYSTEM 

» O02 LeBUFSIZE  CHARC8) 2% NEW FORMAT DECIMAL BLOCK SIZE 

, O3 LeBSIZE BITC24> 2x OLD FORMAT BINARY 

, O3 LeRSIZE BITC24) & OLD FORMAT BINARY 

» O02 LsRECSTZE CHARC8) 2% NEW FORMAT DECIMAL RECORD SIZE 

» 02 LNODE CHARCI) = % NEW FORMAT RECORDING MOOE FOR 
7. TAPE FILE 


Nes 
5 


Ali labels on the 81900 system are written in odd ecarity. 
Beginning with the 4e2 release of the software» tape marks area 
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written in even parity» except where prohibited by the control. 
This was done as an atcomodation to the 9300 system» which can 
read only sevenvtrack tape and cannot recognize tape marks which 
are written in odd parity 


MCPII widt write tapemarks and ending tabels on any outout 
labeled tape that is not at BOT when a Clear/Start is done. This 
widd addow the user to read that tape and recover the data. 
There is one restriction. if the tape is to pe read in reverses 
the user must specify biocking information. 


ANSII labeis are aiso written as the standard tabet on 
seven track tape. When this is donee the dabeis are written with 
transtaticn to BCL. Burroughs tabeis» when written to 
sevenvwtrack tape» are written in odd parity with the EBCDIC/BCL 
translator eanabied. 


The STATUS Procedure makes ail possibile attempts to recognize 4 
fabei when a tape unit becomes Ready. On seven=track taper 
particutartys there are several different variations of parity 
and recording mode that may have been used to create the tape. 
sevenwtrack tape can be written with or without character 
translation from EBCDIC to BCL. The MCP widd attempt to read 
tape dabels with ail possibile variations before giving up. 


When the MCP cannot recognize atabelt» the unit is considered 
available for input purposes if the tape does not have a write 
Ring in ite In this case» it must be manually assigned to 4 
program by the operator» either when the program requests tha 
file or when the job is executed. Lf the tage does cortain 3 
Write Rings it must be initialized» using the 3N instruction 
decsribed above. Oniy when the tape has a Write Ring and 
contains a vatid ANSI tabel indicating “Scratch” is it considered 
avaidable for output purposes automatically by the MCP. 


It is atso the responsibility of the STATUS Procedure to record 
the other information returned by the Test I/0 operation. This 
information is crucial to the proper operation of the tana 
subsystems In particulier» if the system is equipped with a 
PE/NRZ exchanger the operation of the STATUS Procedure when a 
unit becomes Ready is as described below. 
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PEZNSZ EXCHANGES 


Wath the inclusion of the M4/M5 MEC supplied by the Westlake 
Plant and described by P.5. #2047 4499» it is possibile for a 
tape unit to operate in either Phase Encoded (PE) or Non-Return 
to Zero CNRZ) recording moda. This can onty be accomplished on 
the 81000 hardware by connecting one NRZ controt and one PE 
control to the MEC. The NRZ control is designated MTC-2 and the 
PE control is designated MIC~“4. A tape subsystem so connected is 
spoken of as an exchange subsystem by hardware personnel. 
According to the software definition of a subsystem» all controts 
in the subdsystem must be identicai. The code in the 1/0 driver 
which interfaces to MTC-2 is distinctly different from that which 
interfaces with MTC~-4. A request for a unit which 18 operating 
in the NRZ mode can ondy be handded by MTC2. 


To solve this problem» considarabdie coding has been incorporated 
in the MCP. The problem has been rectified in the most efficient 
manner possibie», however. Two separate chains of descriptors» 
one for each controle are constructed by the MCP at Clear/Start 
time. The two chains are maintained by the MCP dynamicailysr from 
that point. 


Recording mode information is supplied by the test operator and 
actualdy is returned as the density: fietd in the result 
descriptor. A density selection of 1600 bDpi» for exarple>, 
indicates that the unit has been selected to be in the 
phasemencoded recording mode and that the I/0 descriptors for the 
unit should be in the STC"4 chain of descriptors. if thea 
subchain fer the unit is not in the proper chaine the MCP will 
move the entire subchain to the proper chain. The movement of 
the subchain is ondy attempted whan the unit is not in user of 
course. Selecting a different density while the unit is being 
used constitutes an error on the part of the operator. The 
operator is notified of the error and the program is attlewed to 
continue processing only when the oproper density has been 
selected on the unit. 


This solution is only possibile if both controls are capable of 
reporting recording density property. MTC-2 can report the fact 
that a unit is selected to be in the 1600 bpi density. 
Simitarity» MYC"-4 is able to report the fact that a unit is in the 
800 boi density. Density inforamation is commonty used by the HCP 
only when a unit goes from a not"ready state to a ready state. 
The movement of the subchain is therefore performed by the MCP 
status routine when the unit becomes ready. 


Unit mnemonics are not affectsad by the presence of a PE/NR? 
exchanges A unit selected as MTA» for exaspier witi always be 
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known as MYA» regardiess of which chain contains its subchaine or 
which density is selected by the operator. 


Oue to differences in the unit numbering scheme petween MTC“2 and 
MT C@4» there can be no more than eight magnetic tape units 
connected to a PE/ZNRZ tape subsystem. This capability is not 
availabie on any version of the software prior to the 521 release 
versione 
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FILE SIRUCTURES 


A Fite is a group of related records. Files are of central 
importance in the I/0 Subsystem since effectively alt of the 
communication between user programs and the subsystem is 


accompdished through files. 


The Bi000 Operating System supports three different fite types or 
structures» exctusive of Data Management System structures» which 
correspond roughly to those file types defined in the ANSI *74 
COBOL Language. In that Language» these types ars catted 
Sequential» Relative and Indexed Sequential. Sequentiat and 
Indexed Sequential files» in COBOL» can both be accessed in a 
random manner and the use of the word “Sequentiai”™ tends to add 
confusion. In this documents the three types wiilt be refferred 
to as Conventionad Files» Retative Files and Indexed Files. 


= : _) 
\ om C eee 
CONVENTIONAL EILES (9% agente 


The basic definition of Conventional file structures is found in 
the COBOL *68 Language» though many functions have been added to 
the basic definition. To a programs a file represents 4a large 
codilection of ordered data that exists apart from the prograr. 
The program needs to interact with parts of that data from time 
to time and the [1/0 Subsystem makes this interaction pcessitte. 
The I/0 Subsystem moves the data into and out of user working 
areas in main meamorys to which the program has access. 


The unit of data moved into and out of the user’s working area is 
the racord. The record is considered» by the I/0 Subsystem» to 
be a string of bits» which the user program witl probably group 
into characters of words in somes manner» but the [/0 Subsystem 
deais onty with entire records and detivers and receives one 
record at a time to and from the user prograsm. 


A fite has some structure as seen by the user program. The 
records may be all of the same Length or they may be of variable 
length. Length information must be declared by the program or 


contained in the record itself or exist in an accessible fers in 
the physical file or exist in the information which the CP 
maintains about the file. [. e record dength is variable» then 
the Length of each record must exist in that records in the first 
four character positions. Peete spe wit. rs or 
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The fide» as it is stored on some recording medium» is often 
refferred to as a physicat file. A physical file may have some 
additional elements of structure. It may contain blocks. A 
block iS a group of ophysicadlty contiguous records which are 
transferred to and from the physical medium as a group. The 


Storage device itself may impose some structure upon the file. 
As discussd previousty» data is transferred to disk in 1440-bit 
incrementse A bteck of records to ba written to disk must 
therefore total some integer multiple of 1440 bits. The disk 
itself may be wused to store many disjoint physical files. To 
minimize storage avaitabitit y probiems» the MCP sdlows disk files 
to be broken into "areas*"» each of which will contain rocm for a 
specified number of blocks. This is described in more detail 
later. 


* 


The physical fiite inherits many of its properties from the 
fogical file declared by the user program which creates it. When 
the user programmer decitares a Atogical file>, the cospiler 
generates a Fide Parameter Block which contains the specified 
values for the various attributes of the file. File Parameter 
Blocks (FP8s) are defined in Section 2 of this specification. 
The MCP» and more specificaliy the OPEN orocedures converts the 
attributes specified by the user to an actuat physicat § fiie. 
More attributes are added to the physical file wher it is 
assigned to a device. 


Any fide may be described by its attributes. File attributes are 
systes control parameters which are used by the I/0 Subsystem. 
The attributes contain att of the information the subsystem needs 
when it connects a physicat file to a togical file declared in a 
user program and when it controls the access to that physicat 
fide 


Mo: jated with any file are contained ir 


the File errs Block (FPS) for that file. Certainty» the FPS 


is the storage medium for the attributes that are dectared by the 
user and generated by the compiler. Additional attributes wilt, 
be obtained when the file is opened and assigned to a device. 
When a file is opens its attributes may be stored in the FPB»s the 
Fide Information Stock CFI3)» the Disk File Header (DFH) and the 
I/0 Assignmment Table (IOAT). Adil of these structures have been 
presented previously. . 


Beginning with the 8.0 version of the MCP» a communicate 
operation was added to adtow user programs to dynamicaity modify 
selected attributes of a file. In subsequent versions cf the 
MCP» the tist of modifiable attribtes has been expanded. The 
File Attribute communicate operation is described in the Demand 
Management section of this document. 
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FILE NAMING CONVENTIONS 


Aldi names associated with files on the 81000 MCP may be a faxinmum 
of ten characters in tength. Names in excess of ten characters 
widd be truncated to the first tone Looking at the description 
of the FPB presented in Sectian 2 of this spectficatiors» the 
first field in the FPS» FPS.FILEsNAME is the internal name of the 
file. "Internal "+ in this case» means internat to the user 
programe. This is the name which appears in the File Dectaration 
of the user program and the name which the programmer uses in ail 
references to the file within the program. 


The next three name fields in the FPS provide the "File 
Identifier" for MCP purposes. Ad@ physical files introduced to 
the system may have one or two names» Files assigned to disk 
pack may have a third name which will correspond to the pact 
name,» the name contained in the pack tabel. 


If a fite has one name only» that name is stored in the fielid 
FPB.MULTIAFILE.ID and the field FPB.~FILE-10 should be filted with 
bi anks. FPBeMULTI.FILE.I1D0 is often referred to as the “"Famity 
ID" and is only important if the file is assigned to disk or 
tape. {Uf a file has two neuese the second name is stored in the 


FPS.FILE.1ID fieid. 


The assignment of physical files to Logicai files is discussed in 
the Demand Management Section of this specification in the 
description of the OPEN communicate operation. Stated in its 
Siapiest form» the MCP attempts to associate one or two names 
with each device that is connected to the system and that is 
capable of input operations and to match this externait name to 
the Fite Identifier specified in an FP®B when a user OPENs a file. 
On output files» the MCP simply attempts to assign an avaitabie 
device of the requested hardware type. 


There are two exceptions to the statewents in the preceding 
paragraph. When an output file is directed to Printer or Punch 
devices» the output data may be actuadiiy stored on disk for tater 
retrieval. Such files are known as Backup Fites and are 
discussed fdater. Input card files may be toaded to disk files 
prior to the time they are required by a program. When the 
program then requests the card files MCP may automaticaity 
substitute the previously ioaded disk files. This is known as 
the Psuedo~Reader facility and is discussed in Product 
Specification 2222 2265» SYSTEM/LOCNTBL. 
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LOGICAL DISK EXLES 


it is the NCP*s rasponsibiltiy to convert a togicai disk file 


declared in a user program» 
"new™ ain this context specifies 
create a file and the physicat disk 


known to the system are cf no concern 


Except in 


the case of Multi~Pack files» 
More than one physical pack or cartridges 
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as 


to an actual physical disk file. 
This can oniy occur by a program opening a new disk file>» 
that 


where 
the program intends to 
files that are currentiy 
to the user. 


files that extend over 
anew fite can oaonty 


become a permanent file that exists when the program ts no longer 


executing by the same user doing a close operation 
and specifying in the CLOSE communicate operator that the fite 
This implies that the file identifier is to 


to become permanent. 


be entered in the disk directory 
forever. This also implies that the 
by that file is to be used (for 
Various user manipulations that may 
utilizing a togicat file with the 
Ciose operation is aiso described 


Management 
and Ciose operations both obey 
definition of the COBDL Language. 


PHYSICAL O1SK ELLES 


In order 
device» the MCP must maintain tables 
locations that are available for use» 


are atready stored on the disk and thea. 


of those files. 


DISK SPACE ALLOCATION 


There are three tables» ¢ 
by the MCP to adtocate disk space. 


section of this specification.» 
the 


file 
is 


on the 


and remembered by the MCP 
disk storage space occupied 
no other purpose except the 
occur within that file> 
same File Identifier. Thea 
in detaii in the Demand 
Basicaliys the Open 


rules oresented in tke 


to manage alt of the availabte storage space on a disk 


which teil it the storage 
the names of the files that 
ohysicat characteristics 


each with the same format» that are used 
The master availabie table is 


a nonwexpandable table of three contiguous segments beginring at 


the second sector on disk. 
segments which have been *XD-ed" by 
available table is a 10-segment table 
Segment 
disk and is expandabie as needed. 


contiguous segments and contains a 


but not reflected in the disk directory. 
At Clear/Start times 


begins at the 57th sector. 


the temporary tabie are returned to 


It contains a List of 


aif unusabtea 
The working 
disk 


the operator. 
beginning at the 47th 


It contains a List of att available or unused space on 


The temporary table is five 
dist of ali segments in use 
This expandable tabte 


ali sectors in 


the availabie table. A 


programmatic description is given below: 
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DEF INE 
DISK »AVAILABLE.»DECLARATION AS# 
DECLARE 
O21 DUMMY REMAPS OISK*AVAILASLE BITC{SEG.SIZE)» 
O2 AWLseFOR*LINK DSK 2ADR> 
92 AVL.»BACKsLINK DSKLADR» 
O02 AVL-SELF DSK «ADR» 
02 FILLER BITCH)» 
92 AVL.»BLOCKC22)> 
O3 AVL~ADDRESS DSK »ADR» 
03 AVL.LENGTH WORD? #5 


FILE ACCESS AND IDENTIFICATION 


The disk directory is the structure which catalogues and points 
to adi files on disk. Each entry contains the file*s namer tyner 
and Disk Fite Header (CDFH) address. The directory is a two7tlevel 
structure containing a primary or “master”™ directory and a 
secondary directory. The master directory is created at Cota 
Start as 16 contiguous disk sectors beginning at sector 31. f€ach 
sector contains entries fer eleven files. As each sector is 
filled» another disk segment is addocated and tinked to the 
filled sector. lf a fite has two names» the ori#ary name 
C(Multi~File IDentification) is placed in the master directory 
with a pointer to a secondary directorys where ail the files with 
that MFID are listed. The secondary directory is structured and 
linked in the same fashion as the master directory. A 
programmatic description is given below: 


DECLARE O21 DIRECTORY REMAPS BASE» 


92 DISK.»~SUCCESSOR DSK ADR » 

02 DISK~PREDECES SOR DSK .ADR » 

02 DISKASELF BSK»ADR» 

92 FILLER BIT £12)» 

02 DISK»NAME NAME » 

92 DISK»ADDRESS DSK »ADR » 

02 BDISK.~FILE.TYPE BIT (4)>- 

Q2 FILLER . BIT €1200)% Z 11 ENTRY PER 


The Disk File Header (O0FH) is a variable-length header record» 
the size of which is dependent upon the number of dectared areas 
in the file and is computed as fottlows? 


5340-BITS + C36“BITS * NUMBER=GF<AREAS) 


SEG 
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The DFR is never tess than 14490 bits nor greater than 4320 bits 
on disk. [It tists the phy sical c characteristics of the file 
including its _file type and the disk address for each areas The 
fodtowing file types are recognized by the MCP: es 


LOG 
DIRECTORY 

CONTROL DECK 

BACKUP PRINT 

BACKUP PUNCH 

DUMPF ILE 

INTERPRETER 

CODE FILE 

DATA FILE | 

VARIABLE LENGTH RECORD DATA FILE 
INTRINSIC FILE 


DISS ELLE IDENTIFICATION 


As discussed opreviousiy» Disk File Headers {BDFH) are the 


structures used to identify a file on disk. it is a 
variable-length record which describes the physical attributes of 
the fide and contains pointers to each "*area” of the file. when 


a disk file is "*opened"» a copy of the DOFH is cepied into germory. 
The gene in memory pete. to the meager on disk and vice versa. 
ia aeaoey at ety Lines Mul ti plea users of the file will use the 
Same copy of the header. Maintenance of disk file headers is 
covered in another section.» A programmatic description is given 
below: 


DISK FILE HEADER 


DEFINE FILE»HEADER.DECLARATION AS #% 
FHeMAPCFILE»HEADER) €e 

FHeMAPCFILE»~HEADER) AS #2 

DECLARE 01 DUMMY REMAPS FILE.HEADER? & 


O2 FHeUSERS.RANDOM BiTCS)*1% FORMERLY FH.CORE.ACDR 

02 FH.NEWFILE Bit€idex% CLEARED WHEN NEW FILE 15 FILED. 
02 FILLER BITC?» 

O2 FH.FILE.KIND BIT(B)» 

02 FHe SELF DSK ADR» 

02 FHeNO.USERS BLT €8)>» 

02 FHAUSERSjOPEN.OUT BIT C4)» 

02 FHeOPEN»TYPE BIT (&)» 

02 FHFILE.TYPE BIT C4)» 

02 FHePERMANENT Bit C4)» 


02 Fe JOBeWAITING.ON»~CLOSE BS00LEAN> 
02 FILLER BITC9I)>® % DON'T USE UNTILL 1977 
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02 FHeHOR.SIZE BETCi4) 2% LENGTH OF MYSELF IN BITS. 
O02 FHeANO»~USERS~LOCK BITC4)» 
% NOUSERS WHO HAVE IT GPENED WITH LOCK 
02 FH.RECORD.SIZE BITC{20)+% LENGTH IN BITS. 
02 FILLER BITC4&)»% DON'T USE TILL 1977 
02 FH.RCDS. BLOCK BITC2 0) »% 
02 FHeBLOCKS.»AREA WORD » 
02 FHeSEGS.AREA WORD» 
092 FHsAREAS.»RQST BIT €12)> 
02 FHeAREA»CTR BIT (12)>» 
02 FHeEQF»aPOINTER WORD » 
02 FILLER BITC4) »XDONTT USE TILL 1977 
02 FH.»ABP5.ND BITCZOI +R 
O2 FH.»B8LOCK.COUNT BITC24)5% DONT USE TILL 1977. IGNORED 5.1. 
02 FH.FORMAT BIT(3)>% HETHERTO =O. FOR RELEASE» =i. 
02 FH.»MPF BITCi)»z HITHERTO 4 BITS. 
O02 FILLER BITC24)> 
02 FH.eCREATE.TIMNE BITCLG)2% HITHERTO O«;/ HENIGE?S GENEROSITY. 
O02 FILLER BITCS)» 
Q2 FHeUSER.~INFOG WORD» 
02 FHeSAVE.F ACTOR BIT (12)> 
J2 FHeCREATION.DATE BIT (€16)>» 
02 FH.AACCESS.DATE BITCL6)«% 
O02 FH.SERND BIT(24)e2% DON*T REUSE TILL 1977. 5.1 IGNOR: 
02 FHeMPF.AADDR DSK wADRe» f DONT REUSE TILL 1977 
02 FILLER BITCi)» 
02 FH.AUPSATE .VERSTION BOOLEAN» 
02 FHAOMS.»WRITE.CONTROL» 
03 FH.OMS.~TO.8E WRITTEN BOOLEAN» 
03 FHOMS~CONTROLPOINT BOOLEAN» 
02 FH»AVERSION BITC36)- % YEAR» JIDAY»TIME 
O02 FH.PROTECTION BIT €2)-% HOST RJE 
02 FHPROTECTION.10 BIT €2)0% HOST RJE 
02 FILLER de BIT €Ci6)e% HOST RJE 
02 FHeAREAACDRESS (105)  DSKsADR» 
03 FHeUNIT BIT C12)» & 
04 FHePORT “BIT (3)- 
04 FH.CHAN BIT C4)» % 
04 FH.SERNGFLAG BOOLEAN? % 
04 FHEU BIT C4)» & 
O3 FH»ADDR BIT €24)3 


MULTISPACK EILES 


The 810060 MCP inctudes the 
over more than one removable 


known as a “MNudtin~Pack Fite” C(NPF). } 
some Limitations on the use of such files. 
contain 


or cartridges s#hich 
removed indiscriminately. 


capability to allow a file to extend 
pack or cartridge. Such a file is 
Quite obviously» there are 
The individuad packs 

the file may not ba 
details are 


portions of 
Yarious operational 


contained in the "817900 Software Operationai Guide”. 
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BASE PACKS 


A muiti-pack fide may have only one "Base Pack™ (BP). The nara 
of the base pack is the pack id as specified by the user in the 
FPB of the mutti-pack fiie. The base pack must be on tine for 
ait OPENs of the file. The MCP may aiso require that the base 
pack be onttine for other operations» such as the assignment of a 
new area of disk to the file. An appropriate message witi be 
typed on the console orinter by the MCP if the base pack is 
required and it is not onwtine. The operator may then mount the 
base pack and the requesting program widi continue. The base 
pack must be on dine when the file is closed if it was opened for 
output or input/output. 


A base pack may contain singte files» as well as multicoack 
files» in any combination.» It aay not» be a "continuation pack” 
for a muiti-pack file whose base pack is a different physical 
pack or cartridge. —— 


The file header for a multi-pack file is contained on the tase 
pack. It contains aii information concerning the files inctuding 
the addresses of every area assigned on the base pack to that 
file. For each area which resides on a continuation packe tha 
header will contain the serial number of the continuation pack. 
This adttiows the MCP to control all processing of the file and 
thereby avoids the necessity of updating sach continuation pack 
as the fite is orocessed. 


CONTINUATION PACKS 


A multix-pack file may» by definition» reside on two or more packs 
or cartridges» hen the file overflows or “continues” toa 
additional packs» the term "continuation pack" is used. A 
mudti~pack fite may reside on up to sixteen packs or cartridges. 
There may be up to fifteen continuation packs assigned to one 
mudticpack file. 


A continuation pack may be associated with only one base pack. A 
continuation pack may contain only continuation files; it may 
net be a base pack for another file. A continuation psck may 
contain information associated with more than one sulti-pack 
file» but ati of the files must be assigned to the same tase 
pack. 
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The fiie header» which is contained on the base pack for a 


multicpack file» contains disk addresses for only those areas of 
disk which are assigned to the base pack». The same statement can 
be made of continutation packs? the file header contained on a 
continuation pack contains disk addresses that are assigned on 
that pack only. The fide header on the base pack contains thea 
serial number of the appropriate continuation pack in the disk 
address fietds of the headers. 


When a file overflows from the base packe the NCP will search fer 
another continuation pack that is adready onttine and that is 
associated with the same base pack. If such a continuation pvack 
is found» the file automatically overflows to that continuation 
pack. If no such continuation pack i85 present on the systems» the 
MCP wilt then search for a scratch pack» one which has nao files 
on it» with the same type as the base pack. "Type" here wseans 
“restricted” or unrestricted” and is detersmined when the pack is 
initialized. 


if such a scratch pack is founds the file automaticaitly continues 


to that packe If no such pack is found» the MCP temporarily 
haits the progras and prints an appropriate message on the 
console printer. The program may be continued when a suitabdte 


continuation pack is present on the system. 
MULTI-PACK EILE INEQRMATIGN TABLE 


when a mudltirpack file is opened inputs the file*s header is read 
into memory from the base pack. When a mutti-pack file is opened 
outputs and newe a header 15 constructed in memory fro 
information in the program's FPB and information from the base 
pack. Ouring OPEN the MCP widt find space on the system pack for 


a multiwpack file information table. The table wilt contain 
specific information about the base pack» atong with an exact 
copy of the disk file header from the base oack. This copy of 


the header is treated as a working copy white the file is open. 
The header on the base pack way therefore not always be correct. 


The format of the MPF.~INFO.TASLE is presented hbetonw. Dne 
MPF.INFO.TABLE per file is required» regardiess of the number of 
user ss 
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FIELD NAHE TYPE 
01 MPF.UNFOQ. TABLE 1392 g1TS 
O02 MPF .F ORWARD 36 BITS 
02 MPF .BACKWARD 36 BITS 
O02 MPF.ASELF 36 BITS 
O02 MPF .NANE 30 CHAR 
02 MPF.AHEADER. SIZE 24 3175S 


O2 MPF eHEADER»ADDRESS 24 BITS 


O2 MPF .eBPS.ND 2% 81Ts 
02 MPF »OPEN.TYPE 4 BITS 
O02 MPF.~NEWeFILE 1 BIT 
O2 MPF eNEW.AREA 1 BaT 
O2 MPF.CS BIT 
02 FILLER 1 BIT 
02 MPFABASEsPACK.TYPE & B1TS 


Q2 MPF .AARRAY 


03 MPF.AONLINE 
94 MPF .SERTAL.NO 
04 MPFAHDR.»DSK 


24 §81TS 
36 BITS 
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DESCRIPTION 


POINTER TO NEXT MPF TABLE. 
POINTER TO PREVIOUS MPF YALE. 
POINTER TQ THIS MPF TABLE. 
FILE“IDENTIFIER. 

SIZE OF COMPOSITE HEATER 


MAINTAINED 8Y THE MCP. 
“POINTER TO THE COMPOSITE HEADER 


IN MEMORY. 

BASE PACK CBP) SERTAL NUMBER. 
TYPE OF FILE OPENED. SAME AS 
DFHeOPEN»TYPE IN DISK FILE HEADER. 
MCP FLAG USED IF THIS [5 A NEW 
FILE. 

MCP FLAG USED IF NEW AREA WAS 
ADDED. 

MCP FLAG TQ MARK IF CLEARSSTART 
WAS PERFORMED SINCE THIS ENTRY 
WAS CREATEC. 


TYPE. GF PACK USED AS 8P. 
L=RESTRICTED» 2=UNRESTRICTED 
USED TG RECORD ALL PACKS THAT 
ARE ON-LINE. 

MAXIMUM OF 16 ITENS IN ARRAY. 


SERTAL NUMBER OF THE PATK. 


QLISK ADDRESS GF THE FILE HEADER 
ON THE PACK. 


MULTIZPACK ELLE GENERAL RESTRICTIONS 


In addition to any restrictions Listed in the foregoing» the 
items below are also applicable to multicpack files. 


1. Since a System cartridge may not be a base pack» multi-pack 


files are only operational on systems with two or more 
drives. 
Ze Aditi packs containing any part of a multispack file must have 


unique serial numbers. 
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PRINTER FILES 


Ali Burroughs printers and controls have hardware capability cf 
spacing the paper after writing a line of output but no 
capability of spacing the paper before writing the line. @ith 
the advent of the ANSI "74 COBOL Language in the 9.0 version of 
the softwares the nead for a more efficient means of performing 
the COBOL WRITE AFTER ADVANCING statement became apparent. In 
prior versions» this operation was implemented by the corpiters> 
generated two actual I/0 communicate operators for each such 
Statement encountered. The first of the two was a Position 
communicate or a WRITE of a tine of bianks> the second was 323 
WRITE of the actual record with no paper motion specified. This, 
of courses resuited in two communicates as weit as two physical 
16s for every togicat WRITE AFTER ADVANCING operation. The 
change described betow was first implemented in the 9.0 Operating 
System and is included in ali subsequent versions. 


The goat of this modification was to reduce the nuaber of 
communicate operations to one per togical WRITE and to reduce the 
physical I/0 operations to one per communicate operation using 
the existing printer hardware» This was accomplished by detaying 
the initiation of the physical I/D operation untid the fodilowing 
dogicad WRITE is received. By knowing both the opreviscus and 
current logical I/70 requestse a physical I/0 can be initiated 
which corresponds to the first request and takes advantage of the 
Burroughs hardware. 


The diagram in Figure i shows the relationship between the tast 
logical raquest issued by the user» the current togicat request 
and the actuadi physicat I/70 operation that wild be performed. 
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\ 
Current\ Pending 
Logicat \ Operation 
Request \ 
| Nudd Write» No Space Write Sefore 
4 Single Space 
F aslentaaianiontenteatateteetetntientonioioieny. Aadeelontetealiltetatatetatestntedetetad. Reletntentetatetetatetetettesitaled | 
Write» 1 No“oD» { Write» No Space 1 Write» Space 1 I! 
No Space 1 Pendingz= i Pending:= 1 Pending:= 1 
1 Write/No 1 Write/No 1 Write/No { 
, Raalatertea hate taliateaieteatetlenientelonl, estonia ete diateaia tai nateetntediad, Saket leila iniainiaaeds 
drite/3B 1 No@00» 1 Writes No apace 1 Write/3 Space i 1 
space i 1 Pending:= 1 Pending:= j Pendingz= 1 
i Write/8 Space 14 Writs/8 on 1 1 Write/B Space 1 4 
Auten ieateetentenhesientenenteindeetiateali, Henielieialeatalateietatetaedndi, Detain taiellaelietetetiekaned 3 
Write/B 4 Write/B Space 2 1 Write» No Space 1 Write/’B Space 1 3! 
Space 2 1% Pendingt=Nudil 1 Write/3 Space 2 1 Write/B Space 2? ! 
1 1 Pendingt=Nutt & Pending?=Niti  ! 
(si cdee nse nesn dg ee ced wet ouada acacia ee wee wea wea eee 
Write/A 1 Space 1 1 Write/3 Space 1 1 Write/3 Space 2 1 
Space Ll 1 Pendings= 4 Panding:= 4 Panding:= i 
_ ¥ Writes No Spaca 1 Write» No Space 1 Writes No Space i 
Eatin eaten ie incittielinadenliad, 2 a ee ce saan ewww fy 
Write/sa 1 Space 2 1 Write/8 Space 2 4 Write/8 Space ? 1 
Space 2 1 Pending:= 1 Pending?= 1 Space it ] 
{ Writer No Space 1 Write, No “Space i - Pending:= { 
| j 1 Writes» No Space i 
| alae haan etait, Seale tae deiedieniaieatenieieiteshel teteieniae tbat | 
Write/3 4% Write/3 Channei 1 Write» No Space 1 Write/B Space 1 1 
Channet 73 Pendingt=Nuli 1 Write/B Channet 1 Writes Channet i 
i 4 Pendingt=Nult 1 Pendingt=Nuti 1 
fw ew ew ewe Bey Ye or . | hh a A a a EO SO A a ee ee 
Write/A 4% Space Channel Ut Write/B8 Channel 1 Write/B Space 1 1 
Channei 1 Pending:= 1 Pending:= 1 Space Channet 1 
1 Write» No Space i Writer No ‘Space j Pending:= 1 
] 1 1 Writes No Space 1 
5 lalate natalie tata, tanker tele atelateaiataheded, he ahead | 
Space N 1 Space x { Write/vB Space x lt Write/8 Space 2 1 
1 Space (N~x) 1 space {N~x} 1 Space (N-1) 5 
1 Pendingt=Nuli { Pandingt=Nuli 1 Pendingz=Nult i 
PRR l te Datalntabetatabatel totale date takate ta kelntateteletaiad dentaialeatalentedetetateiatatieiatetel 
Figure 1 ~ Logicat/Physicat I/0 Retationship 
In the preceeding diagram» the operations within the table 
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correspond to the actuat physical 170 operations that witli be 
performed» which wiidt depend upon the current togical request 
supplied by the user and any operations that are still pending 


from the 


previous request. Write/8 and Write/A may be read 


"Write Before” and “Write After”. The symboi (€2=) way be read 
"is replaced by”. It can be seen in the diagram that some 


logical 


requests wiidi-s at times» resutt in two physical 
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operations being initiated. Under these conditions» it may be 
beneficial to suppiy each printer file with at Least two ou.ffers,s 
if the execution time of the program is the oniy concern. Total 


system throughput wild not be impacted significantly regardless 
of the number of printer buffers and the types of operations 
being performed. If the MCP must wait for the completion of ary 
printer physical [4/0 oparations the time that is spent waiting 
widi be masked by the processing of other programs. 


Adong these same lines» it should be remembered that any time a 
Write operation is teft pending and control is returned to the 
users the MCP must have an available buffer to store the data 


that is to be written. If no buffer is available» caontrot may 
not be returned to the requesting user until a buffer becomes 
availabie. Agains this time witi be overlapped with the 


processing of other programs and system throughput should rot be 
significantly impacted. 


The action presented in the opreceeding chart for a 3pace 
operation requires some exptanation. A Space of more than two 
lines must be handied by the S.MCP. The Micro MCP wild attemot 
to space the requested number of Lines without catiing the S.~MCP>» 
but this is not atways possible. in the diagram» when the 
Pending operation is equal to Nuit» the Micro MCP widt space the 
paper one or two lines» indicated by “x" in the diagram» and if 
N-x is greater than zero» it will pass the remainder to the 
SeMCP. Simitarly» when the Pending operation is equai to a Write 
With No Spacer the Micro MCP wiidd issue a Writa/8 Space 1 or 2 
lines» aiso indicated by "x" in the diagrams» and if the remgainder 
is greater than zero» pass it to the S.NCP. When the Pending 
operation is a Write/8 Space i») the Micro MCP wild issue 3a 
Write/8 Space 2 and pass Ni to the 53.MCP» if N=2 > 0 


LINAGE Clause 


The LINAGE ctause» in ANSI "74 COBOL is a mechanism which ations 
the user to define a “Logical Page” format and request that the 
Operating System maintain printer pages which conform to tha 
defined format» as well as a current Line position on that 
fogicait page» In the Languages the user may specify the Logical 
Page size» an integer whith represents the number of Lines that 
may be printed on any page. This attribute wilt be known as 
PAGE.SIZE in the remainder of this discusion. . 


The user may also specify an Upper Margin» an area at the top of 
each page where nothing wild be printed» Lower Margine a simitar 
area at the bottom of each page» and a Footing areas a specified 
number of Lines in the page body immediately above the Lower 
Margin area. The user may also ask to know the number of the 
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line in the page body whera the last tine of output was orinted. 
This requires that the Operating System maintain a Line counter» 
which will be the number of lines written on the current page. 


The implementation is called the “*Logicad Page” function in tha 
Dperating System and it includes the following: 


1. Positioning to the beginning of the page body ieee past the 
top margin at OPEN or at page overflow, 


@e Reporting End-of-Page when the user writes or spaces within 
the footing area and requests £OP reoorting. 


3. Detecting page overflow. Page overflow is defined as 
occurring whenever the execution of a WRITE’ would leave the 
line counter positioned past the nage body. 


4&. Updating the togical page description when switching fron 
one togicadl page size to another. 


Essentialfiy» the implementation obeys the rules oresented in the 
ANSI "74 COBOL specifications. The operating system will 
maintain a tine counters» a current togical page description and a 
new idiogicat page decription. The line counter represents the 
position on the page body following the opan or the last togicat 
write. The current Logical page description is used to detect 
end-of-page and page overfilowe The new dogicat page description 
is used to initialize the current togicail page description when 
page overfiow is detected and to calcudate the number of dines to 
the first tine of the next page body.» 


If the user has specified end-of-page reporting and the lire 
counter is greater than or equal to the Line number at which the 
footing begins» then on completion of the WURITEs» EOP is reported 
to the users If the dine counter would be greater than the tine 
number at which the bottom margin begins at the and of the 
logical WRITE» an implicit position to the first line of the next 
Dage body i418 generated according to the before/after variant of 
the write statement. At this point the line counter witli be set 
to 1. The number of dines to skip is caicutated according to the 
folitowing formula? 


dines.to»skip *= currents»pag2ebody.size ~- Line»counter + 
current.bottom.marginesizea * new.etop.garginesize; 
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The Logical Page description is updated if necessary when 4 write 
occurs that causes page overflow or whenever an advance to tap cf 
page occurs. 


To access the line counter requires a File Attribute Communicate 
from the user programe This wid be of no concern to ANSI #74 
COsOL users? they need only be concerned with the proper syntax 
in that tanguage for referencing the dine counter. The Logical 
Page definition is changed to the values included in the write 
Communicate format whenever opage overflow is detected. To 
accomodate the above requirements» the format had to be expanded 
as shown in Figure 2 in the WRITE AFTER ADVANCING section af this 
document presented previousi y. 


The Logicat Page implementations since it is implemented ertirely 
in softwares as useable even when the fiie is directed to a 
Backup medium. The Logical Page implementation is aiso useabts 
by programs that are written in Languages other than ANSI "74 
COBOL. This is effected by the implementation of additianat 
syntax in the FILE Controit Card. Progarms may be permanentty 
modified to incorporate the raquired new attributes. The Logicat 
Page function is activated by the PAGE.SIZE attribute in the fite 
Parameter Biock. When 4a printer file is opened and PAGE.SI7E 
contains a value other than zeror page format widl be controtied 
by the Logical Page software implementation and the physical 
carriage controt tape on the davice will be compietety ignored 
after the file is open. 


It 18 important to note that the Channel One punchy as wett as 
the Channel Twelve punch in the carriage'control tape is ignored 
after the file ais open» According to ANSI "74 CoBaL 
specificationss this is as it should be but it dictates that the 
attributes which govern logical page format must be specified 
such that the togical page size ptus the upper margin plus the 
lower margin must total the exact number of tines on the ohysical 
page. If this is not donee then aventuatiy at teaste Lines witt 
be orinted on the crease between the physical pages. 
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The retevant attributes may be referenced in the FILE Cortrol 
Card as shown below. 


Attribute Abbreviation Function 


ER Rie Ree Ria en Ramee Tianna ae eee ieee Nee a ee ie aetiee i aie tener, Npemeenamatth nn tener anne Rian lee Rien eae heen Tana tnianetiamnleanatien estima tis aahianatha nn temehinm teeta Kinetics Remsen, Neen diem eile attanaill na eiimnaiitnntenans temstinedinmadietitemelinnedinial 


PAGE.~SIZE PeS Thea number of lines between the 
Upper Margin and the Lower Margin. 
May be set to any value between 1 
and 255 inctusives 


LOWER.~MARGIN LM The number of lines from the page 
body to the bottom of the fors. 
May be set to any vatue between 
0 and 255 inctusive. 


UPPER.~»MARGIN Uses The number of Lines from the botto”s 
Cor top) of the form to the page dody. 
May be sat to any watue between 
0 and 255 inctusive. 


FOOTING Foor The number of lines from the 
beginning of the page body» 
within. Pageesize»s to the point 
Where the MCP wild begin to 
report endsof"page to the usere 
May be set to any vadiue between 
do and 255 inclusive. 


PRINTER AND PUNCH BACKUP CAPABILITIES 


The MCP includes the capability of directing the output data for 
printer and punch files to intermediate storage. The storage 
medium mays at the user*s option» be magnetic tape or disk. 
Backup files may not be directed to cassette or filexidisk media. 
A utitity routines named SYSTEM/BACKUP» is provided to attow 
users to retrieve the output data from the intermediate storage 
medium. For detaiis on this routiner refer to Product 
Specification 2222 2691» Systema Backup. 


When the output is directed to magnetic taper multi-file tapes 
are created unless the operator intervenes in some manner. If 
the operator does not intervener the tape wiil be closed with no 
rewind when the printer or punch file is closed in the program. 
The next printer or punch Fite which is opened by any executing 
program and directed to backup tape storage wilf then be added to 
the existing tape. This process wiit continue untid the operator 
intervenes or untii the physical end of the tape reel is reached. 
Qperator intervention procedures are described in the Software 
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« 


Qperational Guide and in the MCP Control Syntax Product 
Specification. 


When the output data is directed to intermediate storage on disk» 
it as entered in the Disk Directory when the printer or punch 
file in the program is cdoseds. At that times it may be accessad 
by any programs though ths data contained therein may he 
undecipherable unless the accessing program is written extpressty 
for this purpose. The file may nots under any circumstances» be 
accessed prior to the time the file is closed. 


BACKUP FILE BLOCKING FACTORS 


The OPEN routine tin the MCP attempts to optimize the size of the 
physical blocks associated with a Backup file» according to the 
deciared size of the logical records in the file. The block witt 
typicadty be set to 4a size equivalent to three or four disk 
sectorss each of 180 bytes» by the MCP. in order to predict the 
block size that the MCP will select for any given togicadl record 
sizer it ais necessary to: consider the control information that 
the MCP stores in the first physical block of the file as weil as 
the declared record size.» fhe algorithm that is used by the MCP 
to satlect a biock size is not easily described. The block size 
which is sedected is stored tin the file tabel» for tape files» 
and in the Disk File Header for disk files. The togical record 
size is aiso stored in these fieitds. 


Consequenti ys using the Defautt File Attribute>- which is 
described in the Software Operational Guide and in another part 
of this specifications the user may access Backup files without 
knowing the blocking factor and logical record size in advance. 
Since the atgorithm that is used by the MCP to caicutate block 
size may change from version to versions this weans of 
determining the blocking factor used is preferred. The atgoriths 
that is inciuded in the 8.9 version of the MCP is described in 
the paragraphs that foitlow. : 


The logicad record size deciared ‘in a file in a user*s program 
may be any sizes {f the file is directed to Backup storage» it 
is set to a maximum of 132 bytes» The togicalt record size is 
then incremented by two bytes. This additionad sixteen bits of 
information is necessary to contain the formatting information 
which is passed with each Write and Position communicats 


operator. ef 


If the file is being directed to magnetic tape» the record size 
is then incremented» aif necessary» to force it to a nusber which 
is moduto forty~eight. This is necessary since seven-track tape 
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units require block sizes which are modulo six and phaseencoded 
drives require block sizes which are modulo sixteen. It would 
not be sufficient to insure that only block sizes seet this 
requiremente however» since the blocks on any tape file way 4a 
partiat blocks which contain one or more records. 


The buffer size widt aiways be made darge enough to contain 109 
bits of control information ptus 1668 bits to contain the 
originat File Parameter Block as ait appeared in the user's 
program» plus» if the file is a printer filer 1072 bits toa 
contain a fide tabet pius its associated spacing information. If 
the original file is a punch file» a space of 0648 bits is 
reserved for the tabel instead of 1072. Tae one fact which 
complicates this catcutation is that adit three of the ites 
listed above must begin on a logical record boundary within the 
physical bdock. Consequently» for a file with a dectared record 
size of 132 bytes» which is converted to 134 bytes or £072 bits 
by the OPEN routines the FPA will bagin on the 1073rd bit tn thea 
first physicai biock of the file. The file label» if there is 
ones wiil begin on the 3247th bit €3 x 1072). The first output 
data record wiat then begin on the 4289th bit. The block wiit be 
made targe enough to insure that the first block contains at 
deast one fdogical. record in addition to alt of the information 
listed above. 


For backup files which are directed to intermediate storage on 
disk» the block siza computed above is then incremented» if 
Necessaryr, to make the size module 1440. The number of records 
per btock is then coaputed from record size and biock size. 
Endwof-File is never reported to a user program when a Backup 
fiie is being created. Tha MOP automatically closes the file 
when ait is full and atso automaticatly opens a new Backup file. 
The identifier assigned to the second file widl revert to the 
Standard naming convention for Backup fiies. The MFID wild be 
set to BACKUP.PRT and the [0 fietid wild be set to the next 
Sequantial number maintained by the system. ALi other Backup 
file attributess such as the number of copies requested» wilt be 
retained in the second and subsequent files. ' Ontiy the nama 
requested by the user wilt be iost. 


The MCP adso allows users to specify the file attributes Blocks 
per Area (BLOCKS.AREA or B.A)» Records per Block CRECORDS.3L0CK 
or R.8)» and Number of Areas CAREAS or ARE) for orinter files and 
these specified vaiues wild override the system's default vatues 
for the same attributes. Using the proper setting cf these 
values and the automatic closing and reopening described in the 
preceeding paragraphs users may begin printing a Backup file 
while the program which created it is still executing and 
ereating the second or subsequent portion of the same file. 
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Records in Printer files may not be blocked. . Consequentty» the 
Records per Block attribute is not appiicable when the file is 
directed to the printer. Records per Block is utilized oniy when 
the file is directed to a Backup medium. Alsos the vatue 
specified for Records per Block must be greater than a siniaus 
vaiue» which is a function of the record size associated with the 
fidie and which is computed by the MCP when the file is opened. 
It is reccomended that users not set Records per Btock for 
Printer files in the use of this facility but establish the file 
size via the Blocks per Area and Number of Areas attributes onty. 
For a file with 132-byte records» Records per Block witli be set 
to five by the MCP unless overridden by the user. The simplest 
means of determining the vadue that witd be computed for Records 
per Block by the MCP for any other given record size is to direct 
such a fite to the backup medium and interrogate Records per 
Block. 


The MCP insures that access to a backup file is in serial mode 
only. if the user had requested more than two buffers on the 
original file» the number is reduced to two on the backup file. 
In a simitar manner» the MCP Limits the number of disk areas 
requested to 25.2 The file type in the originat FPS is then 
changed to indicate that the file was directed to disk or tape 
intermediate storage. 


BACKUP FILE CONTROL INEGRMATION 


The first block in any backup file is filted aisost entiraly with 
control information. This information is used by SYSTEM/BACKUP 
when the file is printed or punched. The first twenty-four bits 
of the block widl contain the logicat record size» in bitse as 
computed by the prior portion of the OPEN routine. The next six 
bits of the biock wid contain the number of bits that the record 
size was incremented to make it modutio fortyteight» if the backuo 
medium was Magnetic tape. if the backup medium was disks» these 
six bits witd be equal to zero. The next eighteen bits specify 
the control information size» in bits. This fietd wilt contain 
the number of bits which are used in the first block of the file 
to contain the controt informations exciusive of the Fite 
Parameter Block and the label. In the 9.0 version of the MCP» 
this number widl be equal to 100» aithough ait of the 100 bits 
May not be used. . 


The next twenty~four bits of the black wild specify the FPE size> 
in bits. This number may vary from release ta release. For tha 
9.9 version of the softwWare» the FPS size is 1668 bits.» The naxt 
twenty"four bits will contain the size of the itabels»s if any» 
associated with the printer or punch fite. This field will 
aiways contain these values» regardless of whether the file is 
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dabeied or not. The next four bits widd contain a number which 
specifies the tyne of tabel that is contained in the tabel area. 
In att cases» at the present time» this number will be either 
zero» indicating a standard @abet» or oner indicating that the 
fite is uniabeited. 


Uniess the computed togical record size of the file is exactly 
equal to the size of the control information Listed aboves 109 
bits for the 8.0 version of the MCP» a filter will be added after 
the controdt information. This fitter wilt be of a size 
sufficient to make the next fiesid in the first block» the FPA, 
begin on a togicai record boundary. For exampler if the ocriginat 
logical record size was 132 bytes and the backup medium was disk» 
the fidder would consist of 964 bits. 


The next field in the first btock of the file will be the 
originat Fite Parameter Block a3 it appeared in the user program 
and before any changes were made by the OPEN routine. Onty 
pertinent informations delimited by the size specified by 
FP@eSIZE wit be inciuded. FattLowing the FPB» another filler 
will probably be required to make the next fiaid in the first 
block» the originat file tabai>» begin on a togicat record 
boundar ye 


Actualiys» sixteen bits of spacing information precedes the file 
lapel? the spacing information thus begins on the logicat record 
boundary. For the Label» ald of the sixteen bits will be set to 
zero. These sixteen bits wild be followed by the label» which is 
constructed exactly as if the file had been directed to its 
intended medium originatly. The tabel is always constructed and 
stored in the Backup filter regardiess of «whether the original 
file was tabetied of not. SYSTEM/SBACKUP may or may not cause the 
label to be printed or punched» depending upon whether the fiitea 
was or was not tLabetied. The label in the first btiock wilt be 
foitowed by a fidiers if necessary» to atiow the first togical 
record of output data to begin on a togicat record boundary 
within the biock. The first block wild always contain at teast 
one Logical output record. 


BACKUP FILE LOGICAL RECORD FORMAT 


Each togicad record in the file will consist of sixteen bits of 
formatting information foldowed by the user*s outout data» 
unaltered. If the togicadt record was generated by a Position 
communicate operators the contents of the data fieid are 
undefined and are ignored by SYSTEM/BACKUP. The sixteen bits are 
defined as foltouws. 


ie 


BURROUGHS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP B1i000 MCP EI 
SANTA BARBARA PLANT PeSe 2212 5462 CE) 


Beginning with the 9.20 version of the software» the sixteen bits 
of carriage control information are subdivided as? 


OL CARRIAGE CONTROL BIT €15)» 
092 FILLER BIT €3)» 
QO2 BEFORE_AFTER BITt (€1)>» 
O02 CHANNEL _OR_SPACING BIT (8)>» 
O02 TYPE BIT C4)3 


In the description above» the BEFORE_AFTER field is applicabie an 
WRITE operations which are directed to a printer file. A one in 
this bit position indicates the operation was WRITE AFTER 
ADVANCING. The CHANNEL _OR_SPACING field corresponds to the aight 
bits of spacing information passed on a WRITE communicate in the 
CT-ADVERS fietd in the communicate operator. These bits area 
defined in the Bemand Management section of this decument» bd5ut 
the definition is repeated here for reference. 


CHANNEL_OR_SPACING 

0000 ~- No paper motion 
0001 = Skip to Channet One 
0002 ~ Skip to Channel Two 


ii ui it 


1O0Li = Skip to Channel Eleven 

1100 - Skip to Channel Twelve 

1101 ~- Skip to first Line of the form €1500 LPM 
printer only) 

1119 - Singte spaca. 

1111 - Double space 


uo ii 


“ou 


The TYPE fietd in the description provides information on the 
type of communicate issued by the user on this record. The 
CARRIAGE _OR_SPACING vatue will have different meanings» derending 
upon the value of the TYPE field. The correspondense between the 
two is shown below. —— 


‘TYPE Operation CARRIAGE_OR_SPACING Vatue 

C0090 WRITE Printer Channet Number 

0001 WRITE Punch Stacker Numbar 

0010 SPACE Number of Records to Positian 

00114 . SPACE Printer Channel Number on Position 


C1090 WRITE Printer Spacing Information 
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Relative Eides 


A Relative file consists of records which are identified by 
relative record numbers. The file may be thought of as composed 
of a serial string of areas» each capabie of holding a togicat 
record. Each of these areas is denominated by a relative recor 
number . For exampter the tenth record is the one addressed by 
the relative record number 10 and is in the tenth record area» 
whether of not records have been written in the first through the 
ninth racord area. Relative files are implemented using direct 
files. 


Direct Eiles 


Direct is the primitive file organization. A direct file is 
divided into a number of “record slots" of fixed length» each of 
which may contain one record. A record stot is "empty" if it 
contains no vadid record. Fuld record siots may be made empty by 
deleting the record they contains making the contents 
unaccessabie through the normai mechanism. © Since aii dit 
patterns are potentialiy meaningful as datare a separate drea in 
each block of the file is maintained to indicate which record 
siots within that biock have been used. There wild be one suth 
"Presence Bit" for each record stot in that biock and the doit 


vector thus formed is known as the Block Controt Information 


(BCI). The user is not atiowed to have access to the Atock 
Controt Information under normal circuagstances. 


Relative Eile Data Structure 


The Kedative file is a direct file. The blocks of the Relative 
file contain Block Control. Information t8CI) as wetl as data 
records. The number of data racords in a hiock is conatined in 
the "Records per Block” field of the disk fite header in the case 
of an existing file. Driginaliysr of course>» this nuaber is 
specified by the user programmer in his Fite Declaration. The 
data records wild be tocated on 6Syte boundaries to confors with 
the addressing capabilities of the 81000 Interpreters. The 8CI 


wiit therefore be padded with zeroes to insure this. Khen a 
Relative file is originatiy created» alt of the record stots are 
emotys Consequentiysr the presence bits in the @3CE must he 


initialized when the area is allocated. 


newnnsnsearonaeh 


Sysien/ Filint 


me evenness 


3-55 


BURROUGHS CORPORATION COMPANY CONF ICENTIAL 
COMPUTER SYSTEMS GROUP 81000 MCP If 
SANTA BARBARA PLANT PeSe 2212 5462 (FEF) 


Belative File Disk Initialization 


The use of presence bits toa indicate that a record has been 
written into an available record stot means that disk areas that 
are adtocated to a Relative file must be initiatized when they 
are aditocated. Ali presence bits in the gtock Controt 
Information must be set to zero at this time. 


When a disk area is required» the MCP will be responsibtie for 
aldocating the areap and wiit aidso be resnoonsibie for 
initializing presence bits. if the access mode of the file is 
sequentiat» the MCP just allocates the area and the Logicat 1/79 
routines wild initialize each block before accessing it. If the 
access mode is random or dynamic» the MCP wilt initialize the 
entire area being atlocated by automaticadly executing a speciat 
initialization program which widd run at the user*s priority. 
The user wiitl have the option of executing this prograa himsai fr 
prior to executing the program which accesses the file>» to 
initialize the antire fiie or any areas he choses. In the 
sequential mode» if the file is closed with the EOF pointer not 
at the end of an area» the MCP will initialize the remainder of 
that area. 


The program which initializes newly aliocated disk areas for 
Relative files is catied SYSTEM/RELW~INIT. If this program is 
called automaticaily by the MCP as described above» the orograrm 
which requested the new disk area wild not be allowed to execute 
until SYSTEM/REL.~INTT has coapleted the initialization of the new 


Relative Eile Parameter Blocks CEP3s2) 


The FPB for a retative file is the same as for a Conventionat 
random file except that FPB.»ACCESS is set to a vatue of ?» 
indicating Relative organizations» pls calls 


cea stapes oso 


Relative Disk Eile Headers (QFHs) — 


The OFH for a retative file is the same as for a Conventionai 
file except that the bdock size fieid will include the size of 
the block control information. 
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Relative Eile Information Blocks CEL38s2 


The FIB for a retative fide is the same as for a Convertional 
random file» exceot that a field which identifies the file as 
being Relative has hean added. The field is named the 
FIB»-ORGANIZATION fdeid and can assume vatues eof zero» indicating 
a Conventionat or ANSI "74 Sequential file» one» indicating a 
Relative file» and twor indicating an Indexed Sequential file, 


Buffers for Relative files will be the same as for Conventional 
files. They wild be altocated when the file is opened with one 
1/0 descriptor for each buffer and the buffer size equat to the 
biock sizer which is equal to the record size times the number of 
records per block plus the size of the block control iinformaticn 
Cl bit/record made moduto eight). 


Buffer management for Relative files wiil depend on the user's 
access method ~- Sequential» Random or Dynamic. For Random access 
the management af the obduffers widt be the same as that for 
Conventional random files. READ operations will be initiated on 
demand and WRITE operations will be initiated immediatety after 
the logical I70 operation has occurred. Tf the access sode is 
Sequential» the buffer management widi be the same as that for 
Conventional serial files. The Open procedure witt fitit ali of 
the buffers and the Operating System wild try to stay ahead of 
the user programs initiating physical Read operations when the 
fast togicai record in a buffer has been delivered to a user and 
initiating physicat Write operations when the last togicat record 
of the buffer is received. 


The Dynamic access mode in ANSI "74 COBOL attows the user to 
switch between the Random and Sequential modes. In the Dynamic 
access mode» when switching from Sequential to Random» the last 
block is written to disk if it has been updated. When switching 
from Random to Sequential» the SMCP is cadiled on to fiit the 
buffers as if an OPEN or Position had occurred. In the Dynamic 
access mode» ‘the access awode desired» Random or Sequential» must 
be specified in the communicate operator generated by each 
logical READ operation. 


Relative File Commynicate Operators 


Three new communicate operationse corresponding to the verds 
DELETE» START and REWRITE have been added to the %.0 Uperating 
System. To simplify the implementation and to avoid potential 
fite equivaience problems» nev communicate operations for 
relative files have been added to the software» rather than 
modifying an existing operation. The READ» WRITE and REWRITE 
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communicate operators have a format which is similar to the 
format for the READ» WRITE and REWRITE communicate formats far 
conventional files. The format for the DELETE operation» an 
Relative files» is simitar to the format for the same operation 
on Indexed Sequential files. The ANSI *"7§ COBOL START verb has 
been implemented as a new communicate and is handled by the Micro 
MCP. 
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indexed Sequential Edies 


Indexed Sequential files consist of two new primitive file tynes: 
Direct files and Index files. For each Indexed Sequentiat fiie 
there is one and only one data file and this fite is isptemented 
as a Direct file. For each key of the Indexed Sequential fite 
there is a corresponding fite of type *index". In the MCP code» 
these two types are fisted as INDEX.~SEQ.~DATA.SET.FILE and 
INDEX.SEQSINDE X.FILES they wild be refferred to as Direct files 
and Index files in this document. 


Direct Files 


Direct files were discussed in the documentation on Retative 
files. A portion of that discussion is repeated here for 
convenience. More detaiis wilt be found in the preceeding 
discussion. A Direct file is a primitive file type that is 
divided into a number of "record sdots" of fixed lengths each of 
which may contain one record. A record stot is “*empty™ if it 
contains no valid record. Fudt record siots may be made empty by 
deleting the records they contain» making the contents of that 
Slot inaccessable by the normal mechanism. Since ati obit 
patterns are patentiaily meaningful as a records a bit fiag is 
maintained for each record siot to show the validity of its 
contents. 


Since ali record stots are the same size (MAXRECSIZE) the 
absodute disk address can be easidy cdiculated from the record 
sieot number The file is divided into groups sf record stots 
calfed *biocks"» each consisting of “blocking factor™ record 
slots pdius the “Btock Controt [nformation*» a bit task which 
indicates the presence of a valid record pius enough filler bits 
to make the container modulo eight. There _is a significant 
difference between the Block Control Information for ...a Direct 
file and an Index fide» however. 


xs ce em 


index Eiles 


An Index file is the second new file type. Index files contain 
fixed length records organized in tabtes with B8tock Contrat 
Information to describe the table. Each biock of an index file 
wilt constitue a separate table. The importance of this fact 
widd be explained tater. 
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The records in the Index file consist of Key/Address pairs. The 


addresses point to other tables in the Index fite or to records 
of the Index Sequential file's data fiie» the Direct fildie. The 
tables in the Index file form a tree structure and the records in 


the table are ordered by Ney walue to allow fast random access. 


The tables whose entries point to data records are tinked 
together to afiow fast sequential access. 


Cluster Cites 


In addition to these two new file types» there must resides 
somewhere on disks information relating ati af the various files 
which compose an Indexed Sequential file. This information is 
maintaineds by the MCPe in a third new structure which witd be a 
separate conventional fiie on disk and which will be known as a 


"Ciuster” file. The name of the Ciuster file wilt correspond to 
the user*s dectared name for his Indexed Sequentiad file. In the 
MCP code» this file type is referred to as an 


INDE XeSEG.GLOBAL.FILE>» though it wilt be catied merely a Cluster 
file in this document. 


The Cluster file provides the abitity to reference the entire 
Indexed ‘Sequential file structure by simply referencing the 
Cluster file. When the Compilers generate code which applies to 
Indexed Sequentiai files» they actuatldy reference the Cluster 
file. The Cluster fiie will contain the names of the other files 
associated with the Indexed Sequential fiie. As mentioned 
previously» there wili be one Index file for each key listed in 
the Indexed Sequential file. 


The statement above does not mean that ati of the Index files 
widi be opened when a. Cluster file is opened. The Index files 
are onty opened when they are first referenced in the program and 


this actuadty happens automatically. © The compiters do not 
generate code to open the Index fidiese The MCP simply detects 
that the referenced index fite has not yet been openede obtains 


the necessary information from the Ciluster file» and opens the 
fi le. 


The Cluster file does require an addi ional sk Fite Header in 
memorye but oni : axe "Sag dene ial file is being 
opened. It is not necassary for’ it to be in memory after the 
Fite fas been opened.» The Cduster file also adds an antry to the 
user*s disk directory. The diagram below shows a Cluster file 
schematicaldy. This particudtar fite has one pripar ys or “Prime” 
Key and one Aiternate Key. 
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This organization for Indexed ‘Sequential files offers several 
advantages over any other. Each filter the file which contains 
the actuai data and adi of the Index files» witt have fixed 
record and btock sizes. This wilt simplify the problem of 
managing the buffers that are assigned to the files. Both of 
these fite types are nothing more than Conventional files with 
some order imposed upon the contents of tha file. Consequenti yr 
the Disk File Headers» or "File Descriptors™ required for each 
file are the same as those for Conventional files. This ts 
discussed in more detail tater in the decument. 


Conceptuatiys», this mechanism is easier to visuatize and implement 
than would be mudtipiea structures residing in one physical file. 
Al so» any of the fites may be Located on different spindles» 
which widd cleariy improve performance» since arm movement time 
may be overlapped» and access to ait of the files may occur 
asynchronously. The Direct file and the Index fite may be 
accessed independently of each other. 


The design does impose certain restrictionss which falt in the 
category of “operational” restrictions and which do not ijapact 
performance. A checking mechanism is required to insure the 
integrity of files which are accessed indepsndentiy. The MCP 
must insure that the correct version of the Index file is used 
with its corresponding Direct file. Also» some extra memory for 
Disk File Headers wild be requiredr since sore actuai Feaders 
will be required. A naming convention for ali of the files must 
be imposedr thus removing some smail amount of generatity from 
the user*s capabilities. This may actuality be an advantages 
however « The naming convention is implemented in the Compiler» 
not in the MCPs though this may not be apparent tor and should 
not be important to the user. 
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The Cihuster file is a Conventional data file which contains the 
information relating ati the component fites of the Indexed 
Sequentiad fiie. The structure of the Cluster file 9s similar to 
the Data Base Dictionary format in the Data Management System. 
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The DFHe-EXTENSIGN and Structure Descriptor fietds shown above are 
both discussed in the paragraphs that. folion. The pointer shown 
above from the Fite Table is one of many. There is an entry for 
each file inthe File Table and each entry has a pointer to its 
associated ODFH.~EXTENSION. 


Indexed Sequential Data File Structure 


The data file of an Indexed Sequentiai fite is a Direct file. 
Tha bdocks of the data file contain Block Control. Information 
-€BCI) and data records» simitar to the blocks af a Relative fite 
as presented previously. The number of data records in a block 
is specified by the Records per Block field of the disk fiie 
header. A simidar structure is wsed on Indexed Sequential files 
in the Data Management Systeme Bock Control Information for the 
Index files assoctated with aft Indexed Sequential files is 
significanttiy different from that for Relative files. 
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Indexed Sequential Index Eide Structure 


Index files contain records consisting of Key/Address pairs 
within a block. The fide itself is a tree structure whose nodes 


are blocks. Each block of the file is a node or table. The 
first node is tha root tablee- The root table and tables on alt 
levels except the tast are calied coarse tables. The tables in 


the fast itevel of the tree area catted fine tables. Entries in 
coarse tables point to the next tleved table whose highest entry 
matches the key of the coarse table entry. Fine table entries 
point to a record in the Direct file whose key matches the fine 
table entry (See Figure 3). Fine tables are Linked together in 
logical order to provide fast sequential access and easier 
Current Record Pointer (CCURRENT) maintenance. 


The addresses in these tables are not absolute disk addresses. 
Instead» they are thirty-two bit combinations of an area number,» 
a segment nureber within the area and a displacement into the 
segment. This displacement is merely the record number within 
the biock. Add addressing of [Index tables as wett as of records 
in the data file is accomplished on a relative basis as opposed 
to an absotute one. 


The blocks in Index files contain Block Controt Information of a 
different content and format. The format and content of tha 
Block Controt information maintained in an Index file is shown 
below. A simidar structure exists for OMS Index files. 


OL INDEX.~FILE BCI BIT C38)» 
O02 BC.TYPE BIT (€2)5% O=COARSE» L=FINE 
02 BC~PRESENT»RECORD COUNT BIT C12)» 


O02 BC.NEXT~LOGICAL BLOCK BIT €24)3% VALIO FOR FINE TABLES 


The individual records in the Index files have a fixed formats 
Since the Key specified by the user must be contained in thesa 
records» the size of the records may vary with the keys but the 
format will always be as shown Below. The same format is used hy 
the Data Management System for records in Index tabties. 
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D1 INDEX.RECORD DECLARATION» % FOR DMS AND ANST *74 INDEX FILES 


02 TR.~POINTER» 
O3 TR»~AREA.DISP> 


04 IReAREA~NMBR | BITCS)>» 
94 I[R.~SEG.eNMBR BITC1I6)» 
03 IROFFSET BITC&)» ZX WALID FOR FINE TABLES 
02 IR.~KEY BIICKEY.SIZE D> 


The organization of an Index file is shown in the diagram tetow. 


F lela kelinteiel 2 “+ 
i root 4 1 
i table 1 I 
eoew eee ny i 
1 7: #1 4 
1 4 7 ii 
eee ee ee ee ee ee | | oe eee See eee ee | rn 
j i j id 
\i/ \as Als {ea 
fesse meow ny Powwow moma ny pwowne wane 1 x 
| coarse i 1 coarse i i coarse I! 1 
1 tabite 1 i tabte 1 i table 1 i f 
pow e anny $row sw seem ny eee 14 
4 a... 4 i it 
| i | § ie 
i 1 i I i 
\l/ \a/ \i/ \} i 
wen en nee ny $m wneewen te Few eee mem ay Pt tatetae | 4 
i fine j i fine j 1 fine j i fine i | 
1 table i<eerw--i table i<--"-1 table i<---1i tabie 1 i 
Freeman nt fase emeny tala teteiekat | fowwnwemeny -- 4 
4 ij j i 1 1 4 
{wee ere See een] as eee mes 1 #79 7 wsse= 
j altar letetel Leta lolelatatatel Relatetabatat 
\a/ \as7 Nay Nas \is \is \Vs 
FT lala lon al allen alent alent ieeeniocheeateetaietaietetahetebeeatatehalateataietehatahatetanebeten | 
i ; j 1 
i data file j 
1 i 


EE OE Oe ee 


Figure 2 - Index File Organization 


This structure for the Index files allows the inmptementation of 
the most efficient search and addition algorithms. Linking the 
fast tevet of the fine tables together aitous efficient 
sequential access of the records in the data file. Using this 
link» the CURRENT need oanty point to the last antry accessed in 
the fine tables and not to the path through the coarse tabtes to 
the fine tabtes. This etiminates the need for restrictians oan 
the number of fevets aldowed in order to maintain the CURRENT. 
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It adso makes checking for changes in the CURRENT» caused by 
other users atcessing the files easier. 


The Fide Parameter Biock (FPB) of the Cluster file of an Indexed 
Sequentiad file widil be positioned in the code file among the 
other FPBs according to the order of it*s decilaration in the 
user*s source code. In addition to the information normally 
contained in an FPB for a Conventional file» a Cluster fite FPa 
Widd contain a type fietd which identifies it as a Cluster fite 
FPB» a pointer to the data fiie FPB and an integer which 
indicates the number of keys associated with the Index Sequentiat 
file. There widt be one FPB for each Key declared and these FP8s 
wili immediately follow the FPB for the data fite in the code 
file of the program. This is shown in the diagram in Figure 3. 


Default values are used for the file attributes of a Cluster 
file. The user may not change these values. The number of disk 
areas wilt be set to oner records per biock wilt be set to one» 
block size will be set to 180 bytes and blocks per area witt ba 
set to 50. The ALL~AT.QPEN boolean wilt be set» causing the disk 
area to be allocated when the file is opened for the first tine. 


3725 


BURROUGHS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP RB1000 MCP II 
SANTA BARBARA PLANT PeSe 2212 5462 CE) 
i 4 
i PROGRAM PARAMETER 1 
4 BLOCK | 
#--"1FPB.POINTER | 
J Se eee See CE See na 1 
i 1 4? 
j VA SCRATCHPAD AREA AA 
J Jf CODE wi 
| sp, ee ee ee ENE eee ee, | O02 FPS.FILE.TYPE BIT (8) 
#-->] FPB €file 0) j : 
( Ee ee Ee AE NE NE: 3 
1 FPS (Fide 1) 1/7 02 FPB.IS.SUB.FPB.PTR S81TC 12) | 
Df ct Seo te er oh _if % number of FP8s displaced froa 
1 4#6FPB CCLUSTER. FILE) j % the first FPB (fitte 0). 
| ant Se ae aE TR MATER O02 FPB.IS~NUM.SUB.FPBS BIT CB)»* 
] vi vi oN 02 FPB.ITSsNUM.ATOeDESC Bit C5) p* 
i \\ REMAINING FPS AN 
1 : dt en ee Re 2 J \ 
#-->] FPB (DATA FILE) i 
ee Meee SER TP 
} FPB CKEY # 1) a\ 
| RRL oT ee Rae Tee aN 
1 FPSB CKEY # 2) ma N 
| ee ee ae ee ele eee is" 
if 3 wi. O01 KEY.PARAMETERS» « 
AN 3 \VO 7 O2 KEY.»FLAGS» te 
PF 8 oe ey oe 03 KEY~PRIME BIT <ide* 
1 #FPS (KEY # ND a 03 KEY.~DUP. ALLOWED BIT Cid»* 
ae ee te RES: 02 KEY.DESCRIPTION> * 
. 03 KEY.~QFFSET BiTC16)-* 
03 KEY.STZE BiTC1i2)»«* 
03 KEY.~SITGNED B17 Cids* 
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-* New fieid in 9.8 Software 
Figure 3 = Code Fite on Disk 


Some changes were aiso necessary in the Program Parameter Block 
in the 9.20 software. The changes are required to prevent 
programs which contain Relative and Indexed Sequential fites fron 
being executed on versions of the MCPs retleasad prior to the 9.0 
versions furthers» program code files which are executed under 
controt of the 9.0 NCP may no tonger be axecuted under controt of 
any prior MCPs. For this reason» users who anticipate returning 
to prior versions of the NCP are advised to retain copies of 
their code files and to not execute these copies under controt of 
the 3.90 software. 
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Indexed Sequential Memory Structures 


Generali y» the memory structures used in the Indexed Sequential 
impiementation are much dike the current Data Management ‘System 
Memory structuress with but a few exceptions which take advantage 
of the more specific requirements of the ANSI '%74 CCBOL 
definition. Unitike DMS» which does not use Fite [nformaticn 
Biocks in memoryr Indexed Sequentiad files wilt have an FB 
dictionary entry which wilt point to an Indexed Sequential FI. 
Since the files may be shared among the programs that are 
executings this FIG wild contain onty the information pertinent 
to a specific user and will be referred to as the User Specific 
Information CUSI) field. 


The USI will contain a pointer to the file specific inforsation» 
the information that relates only to the file itself regardiess 
of who is using it. The centrat element in this structure is the 
information necessary to relate the various component fites of 
the Indexed Sequenti ai file. This is actuatiy gloabat 
informations global to ali of the userse and wild contain a table 
whose entries point to information specificaliy concerning the 
component file. The structure which contains this information is 
referred to as the Index Fite Structure Descriptor (STR). There 
widd be one Structure Descriptor for the data fite and ore “(for 
each Index file associated with the Indexed Sequential file. 


Structure Descriptors contain pointers to the OFHe Buffers and 
CURRENT information associated with the various Index fites. fhe 
relationship of the various memory structures used is shown 
diagramaticaity in Figure 4. 
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Figure 4 - [<5 Fife Memory Structures 
FI8 Dictionaries 


From the user™*s view pointer Indexed Sequential files are more 
like a Conventional Random fiter except for the fact that 
symbolic key values are used» than they are like OMS structures. 
Though the Data Management System is a superset of the Indexed 
Sequential impdementation» the user is more likely to have 
severat smali and transient Indexed Sequential files than one 
darge file which he would treat as a data basa. 
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A secondary» but important» goat of the design of the ANSI ‘*%74 
COB0L implementation was to ahiown a smooth integration of 
Relative and Indexed Sequentiat files with the Conventionai file 
mechaniss. For this reason and for other reasons» access to an 
Indexed Sequential FIB is via the FI8 Dictionary» which is alsa 
used to access Conventionad file FIBs. The FI8 for an Indexed 
Sequential file is itself quite different from the FIS for a 
Conventionat file. The Indexed Sequential file is associated 
with several physical files» whereas the Conventionat file is 
associated with only ones Alsoe more than one user way share the 
informations including the data bufferse of an Indexed Sequential 
FIO; a Conventional file FIB is used by onty one user. Tf two 
users are accessing the same physical Conventionat file» each 
user wilt have his own FI. : 


For these reasons» an Indexed Sequential FIA cantains three major 
parts: 


1. User Specific Information 
2@e File Globad Information 
3-2 Component File Specific Information 


The entry in the FIB dictionary corresponding to the Indexed 
Sequential file points to the User Specific Information (USI) of 
this Indexed Sequentiadt Fis. 


Indexed Sequential User specific Information (USI) 


The USI contains information associated with one user only. The 
MCP must know how the user has opened the fite» for example as 
INPUT» and how the user is accessing the filer such as 
sequentially. This information is kept in the USI. User 
Statistics» status and NCP workspace are also kept in this 
structure. Finaildy» there is a pointer to the next part of the 
Indexed Sequential FIB8-» the gtobat information associated with 
the physicat file. . 
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O01 USER.~SPECIF IC INFORMATION» 
02 FIB~COMMON.~PORTION BIT(220)e% The first 

03 FIB.~BOOLE ANS BIT(58)» % 220 bits of 
04 Fi8.0PEN BiT(id» xX UST are the 
04 FI8.CLOSING BiT{t)» % sage as 
04 FIB~nOQUTPUT BiT{L)» xX Conventianal 
04 FI8. INPUT BiT{i}e % FIBs 

03 FIB~ORGANIZATION BIT{C 4)» 2% 
% 1 = RELATIVE 
4 2 = {INDEXED/SEQUENTIAL 

02 USI.FId8» 

03 FIB.USIANOT.FIRST.~TIME. THRU BIT (i). 

03 FIB.UST~LAST.AQGP READ | BITC1)» 

O03 FIBUST.BUPLICATE BITCLi)» 

03 FI8.UST.~MATCH.»FQUND BITC1)» 

03 FI8UST.UPDATE.FLAG BITCiLd» 

03 FIBUSI.FIRST.PASS BITC1id>» 

O3 FILLER BIiTC2)-« 

03 FIBAUST*ACCESS.~NODE BIT(CS )» 

03 FIB~USTI.JOBsNUMBER BIT(24)>» 

D3 FIBmUST.RECORD.ADDRESS BITC24)>» 

03 FIBAUSIKEY»POINTER BIT{24) >» 

O03 FIB-UST.~COMNUNICATE ~WORKSPACE >» BITCHLG d+ 
04 FIBAUSIT.BINARY.~SEARCHAARGUEMENTS B1TC208)> 
C04 FIBAUSIAINTERFACE.PADS BITC96)>» 
04 FIBAUSTASAVE»STATE »AREA BIT{312)» 

03 FI8~USI.GLOBAL~POINTER BIT{(24)>» 

O03 FIBAUSIT.CURRENT.«STRUCTURE Sitch)» 

03 FIBUST.HEADER a1T(24)% 


Indexed Sequentiat File Global Loformatign (GL98A4L5) 


As shown in the above diagram» the first 220 bits of the User 
Specific Information are the same as the first 220 bits of an fia 
for a Conventional file. The rest of the information can be seen 


to be items that are peculiar to a ssaecific user of the 
structura. It 3s information that is necessary for Operating 
System storage of the “state” variables that may be required to 


perform a single operation for this user. 


Included in this information is a pointer ta the next portion of 
an Indexed Sequential FIBs the file Globat information. This 
information» known as the GLOBALS fiedde contains information 
about the various physicat fites which comprise an Indexed 
Sequential fide. Its wain function is to provide a path to the 
required files necessary to compitete an I/09 operation. A 
secondary function is to store information global to the Indexed 
Sequential file. 
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The path to a particular cosponent file is provided by a systen 
descriptor contained in a table of system dascriptors. The first 
antry of the table points to tha data fite. The remaining 
entries point to Index files» one for each key declared; they 
appear in the ordar of the declaration of their corresponding 
keys. For any operation which specifies a key» the compiter witi 
specify the key number» which will be used as an index into this 
table. 


The global information consists of pointers to the chain of [70 
descriptors to be used for operations on the Indexed Sequential 
data file» a count of users who are updating the file» and Lock 


bits to support ANSE *74 COB0L4’s fide tevel tockout. Ai so 
contained in GLOBALS are the count and fiag fietds necessary to 
enforce the prohibition on concurrent updates.» A programmatic 


description is shown below. 


01 GLOBALS 
O02 GLOB.VERSTON.~NUMBER BITCB)» 
O02 GLOB-NUMNBER.~OF .USERS BITLG)» 
O02 GLOS»NUMGER.OF .UPDATERS BITC6)» 
O92 GLOG~DISK~COPY ADDRESS DSK»AADR » 
O02 GLOB-SIZEIN.~BITS _ BITCL6)}» 
92 GLOB.MENORY. ADDRESS BITC24)>» 
O02 GLOE-LOCK.2@17TS BLT(2)» 
O02 GLOB.~10.D0ESC.~CHAIN.~ADBDRESS BIT( 24)» 
O02 GLOBMAX STRUCTURE ~NUMBER BITC8)» 
O02 GLOB.FLAGS BIT(6)» 
03 GLOB.OMS.FILE BIT{1)>» 
03 FILLER . BITC&)» 
03 GLOB.WRITEERRGR ~  s BITC)» 
02 GLOB.CONCURRENT.WINFO> % AT THIS OMS INFOQ AND 
03 GLOB.INUSE.COUNT . BiTt6)>» 2% IS INFO ARE DIFFERENT 
03 GLOB.}CONCURRENT.FLAGS » % TIL STR DIRECTORY 
G& GLOB~FILE~AVATIL BIT(1L)» 


04 GLOS.UPDATE.REQUIREDORINPROC BITCL)» 
O02 GLOB-STRUCTURE~DIRECTQRY » | 
03 GLOB»STRUCTURE.DESCRIPTOR SYeDESC» 


Adi of the pointers to subsequent portions of the Indexed 
Sequential structure» ali of which are known as Structure 
Descriptors» are contained in the GLOGALS fieid. This siaptifies 
the task of maintaining the structures and it atiows the buffers 
to be shared among the various users. It adds ane tevet of 
indirection to ald accesses to the data of courses but this 
expense is smatt for the benefits it yieids. 


BURROUGHS CORPORATION 
COMPUTER SYSTEMS GROUP 


SANTA 
The 


and 


BARBARA PLANT 


Indexed Sequential structures 


kept in the Structure Descriptor. 
the key within the data records» 

duplicates are atlloweds and whether or not it is the prime key 
are all stored in the STR. A programmatic description is 
below. 


O01 STRUCTURE _ DESCRIPTOR » 


02 
02 


As shown in Figure 45 the Structure Descriptor ‘contains a pointer 
the NCP-defined structure which 
as it aaiways has» 


to the Disk Fite Header>r 
last ftevel. 


the 


STReNUMBER 
STR~TYPE 
STReUSER»COUNT . 
STR.~BUFFER.LOCK 
STRBUFFER.LIST»POINTER 
STReRECORDS.~PER~SLOCK 
STR.»SEGMENTS .PER.~SLOCK 
STReRECORD»SIZE 
STR»BLOCK. SIZE 
STR. BLOCKS.~PERAREA 
STRASEGS «PER AREA 
STReOFHAADDRESS 
FILLER 
STR»*CURR ENT.~jPOIN TER 
STR»FLAGS 
03 STRPRIME.KEY 
03 STR»AOUPLICATES.~ALLOWED 
O03 STReSIMPLE.KEY 
03 FILLER 
STReSPLITFACTOR 
STR»KEYsINFO> 
03 STRNUMBER.OF.SUB.KEYS 
O03 STR»SUB~AKEY» 

O04 STR~ITEM.OFFSET 

O04 STR ITEM.ASTIZE 

94 STRAITEM.SIGNED 

04 STReITEM.~DESCENDING 


inforsation retating atmost 
characteristics of the file. 


headers 


The 


version of the 


software to 


This structure» 
exclusively 

Any togicai information in the 
was obtained 


COMPANY 


Structure Descriptor is simitar to an FI8 for a Conventional 
fiite except that all of the User Specific Informstion 
maintained in the U5! For the Index files of an 
nacessary key information i5 
For examples 


size» 


AITCadD» 
BITC4& )» 
BIT(6)» 
BITC2)- 
BIT(24)>» 
BITCi2)> 
BITC 8)» 
RITL16)» 
BITCL6)» 
BITC Lo)» 
BITC15)» 
BIT{24)>» 
BITC15)>» 
BIT(24)> 


BITC{1)» 
BITCid>s 
BITL1)» 
BiT(S)- 
BITCi2d» 


BIT{ 8)» 
BiTtCi6)>» 
BITCi2)> 


Bitt{l)» 
BITCL); 


ta 


such as record size and records per block, 
from the program which originally created the file. 


format of the disk file header had to be expanded in the 9.9 
accomodate the 
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implementations Prior to the creation of the 3.0 version» 
several pieces of information associated with ONS Data Bases» 
which should have been part of the OFH» were mairtained 


separatety due to a iack of avaitable space in the then curent 
definition of the disk file header.» §$Thesa fields have aiso been 
incorporated in the new disk file header. The new format has 
been designed to prevent the occurrence of such problewms in the 
future» whenever the need for nen fields in the DFH arises. 


Disk Eile Header Extensions 


Some efficient means of available disk space maintenance had _ tsa 
be devised for Indexed Sequentiai files. To accomplish this» the 
necessary information regarding the available space is maintained 
in the Cluster file as a data record. When an Indexed Sequenti ad 


file is opened» this information is brought into memcry and - 


Indexed 3eguential Disk Eide Header Extension 


When the Indexed Sequential fide is openeds the information an 
the available space within the Direct files» atl of which space is 
not availabie as far as the system is concerneds is brought into 
memory and stored in the DFH Extension. The format of this 
information in memory is as shown below. 


OL DFHATSsEXTENSION> 


02 FILLER BITCL6) >» 
O2 DFHeTS*EXTENSION. SIZE BITC16)» 
O02 DFH»IS*EXTENSTON» VERSEON BIT(36)> 
O02 DFH.IS.NEXT»FREE.RECORD BIT(32)» 
02 OFH.1SNEXT.FREE. BLOCK BIT(32)> 
02 DFH.ESsROOT»TASLE 3 BLT(24)» 
02 DFHeIS.UPDATEsFLAG BIT (L)3 


indexed Sequential Available Soace Aliocation 


The Indexed Sequentiat fite system maintains two fields in the 
ODF HeEXTENSION of each file which keep track of available space 


within the Direct fiie. This available space should not 2 
confused with the avaiijabte disk space that is szaintained by the 
system. Available space in an Indexed Seguentiai file or in a 


Relative fiie means that a record has never been written into an 
avatitiable record stot or that a record was written at some tine 
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but was subsequentiy and is now deleted. To the systems» ail af 


the space atltocated to the file is in use and none of it is 
avaidabte. 


Both of the availabie space pointers shown above» 


DFHeISsNEXTsFREERECORD and OF He TS.NEXTFREE «BLOCK» wilt contain 
addresses of btocks which have avaitabdie spacee The 


NEXT»FREE.RECORD pointer does not actuadily point toe a record but 
points to the biock which contains the available record stot. 
Record stot atiocation within a biock is accomplished using thea 
presence bits in the Stock Control Information for that block. 


The DFH»~TS~NEXT.~FREE.BSLOCK fieid will contain the area and otock 
number of the next totatliy available biock at the togical end of 
the file. The first disk area of the data file is allocated when 
the fite is first opened and the NEXT.FREE.8LOCK field is set to 
zero» a vatid address» at that time. Atsor when the file is 
first opened» the NEXT.~FREE.RECORD fieid is set to aFFFFFFFF 2. 
When the Micro MCP needs to add a record to the fite ard the 
NEXTFREEs*RECORD field contains aFFFFFFFF  Q> it weans that no 
records are avaitable in a block that has atready been 
initiadlized. The attocation must be accomplished using the 
NEXTFREEBLOCK fietd. 


The Micro MCP wilt then initialize the Presence Bits in the Slock 
Control Information of the block addressed by the NEXT.FREE.~BLOCK 
fieid» move the address. which is in the NEXT.FREERECORD fieid> 
in this case aFFFFFFFFa to the first thirty-two bits of the tast 
record stot in the biocks»s move the address of this block to the 
NEXT»FREERECORD field and increment the NEXT.FREE.SLOCK fieid. 
If the incramented vaiue of the NEXT.FREE~BLOCK fietd causes this 
disk area to exceed the specified size of a disk areas aFFFFFFFFa 
witt be stored in the WNEXT.FREE.BLOCK field instead. The use of 
this value is discused in a subsequent paragraph. 


The record which is being added is then moved to the first record 
stot in the newly afd@docated biock» the presence bit for this slot 
is set and the bdock is written» The presence bits for the 
second and ali subsequent record stots within that block witt be 
set to zeror due to the initiaiization process.» a@FFFFFFFFas thea 
value that was previousdy in the NEXT.FREE.RECORD field» witt be 
stored in the first thirty-two bits of the tast record stot in 
the biock. ‘ie 


When the next record is added to the file» the Micro MCP wild 
again examine the NEXT.FREEARECORD fietd and it witli now contain 
the address of the block that was just allocated. The Micro MCP 
widl read the block into memorys if necessary» and examine the 
Presence 8its in the Steck Controt Information. The firsr 
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avaidtabte record siot wiil be the second slot within the block. 
The Presence Bit for this slot wiht be set andes if this is the 
last record stot in the blocks the OFFFFFFFF3 stored in the first 
thirty~two bits of the record stot witt he moved back to the 
NEXT»FREE~RECORD faedids» and the record witt then be stored ir the 
slot. If the second record stot is not the tast in the bicck», 
aFFFFFFFF2 widd remain in the actuadi f4ast siot and the 
NEXT.~FREERECORD fieid wittl not be changed. 


Aldocation in the Direct file wiittl proceed in this tannere 
assuming that no DELETE operations are performed» until the disk 
area becomes filied and» .a8 mantioned previousiy»  aFFFFFFFF2 is 
stored in the NEXT.~FREE.~BLOCK field. This value serves as an 
indicator to the Micro MCP that the next disk area has nat yat 
been allocated by the 3.NCP. When the Micro MCP encounters this 
valuer it merely passes control to the $.MCP which wiilt allocate 
the area and store its address in the disk file header and in tha 
NEXT.FREE.~SLOCK fieid. The Micro MCP wifi then initialize the 
Block Control Information and procead as was described 
previousiy. 


The process just described may be interrupted by the occtrrencea 
of a DELETE request from 4a user. When this occurs» the address 
in the NEXT.FREE.RECORD stot is stored in. the first thirty-two 
bits of the record baing deleted» the Presence Bit associated 
with the defeted record is reset and the block is written ta 
disk. The address of the block which contains the deteted record 
is then stored in the NEXT.FREE.RECORD field. The next time 3 
record is added to the filer it will consequently be stored in 
the area occupied by the record that was just deteted ard the 
NEXT.»FREE.~RECORD fieid witt be restored to its prior value. This 
operation shoudid eliminate the nesd te periocicadiy rewrite the 
entire fide to elisinate targe numbers of empty record stots» 4 
process commonly known a8 "garbage collection". 


Should more than one record in a block be deleteds the Micro MCP 
ondy needs toa insure that the first thirty-two bits of the tast 
avaitabie record stot in that block contains the address of the 
next block in which a record stot is avaidable or QFFFFFFFFa if 
there is no such next block. This is true even if ait of the 
records in a block are deleted. No pointers need be changed» in 
this latter case» until the next DELETE operation occurs. 
Assuming that no new records hawe been added in the interin» the 
Micro MCP then needs only to insure that the address of the block 
which is totality empty is stored in the siot previously occtpiad 
by the deleted record. 


Altocation of space for an Index file associated with an Indexed 
Sequentiat fiie is somewhat simpler than for a Data filer since 
record availability does not have to be maintained. Whenever a 
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record is deleted» the pointer to that record in the Index fite 
is destroyed and the table contained in the biock is compacted. 
The count of the actuat number of entries in that blocks which is 
maintained in the Block Control Information of an Index file» is 
decremented. No other action is required for the Index fite. 


Maintenance of the NEXT.FREE~SLOCK field of an Index file is 
exactdy like that for the data file. This field wilt atways 
contain the address of the next availabie block at the togicatl 
end of the file. The Wicro MCP widd seat the fieid to aFFFFFFFF3 
when the next disk area must be aliocateds exactty as is done for 
the data file. 


The NEXT»FREE~RECORD fieid is used to address a tinked tist of 
biocks within the fide that are completely ampty. This can onty 
occur when all of the records that were addressed through this 
block have been deleted» a situation which shoutd seldom occur in 
actual use. 


Index Eile Tabie Splitting 


The “splitting™ of fine tables in the Index file is an operation 
that is aiways performed by the S NCP. Any time the addition of 
a record to the file causes a need for a fine table to be divided 


in twos the Micro MCP passes controi to the SDL portion. 
Consequentiys the.S.NCP perforas most of the available space | 


maintenance for the Index files» while the Micro MCP performs the 
majority of this work for the data files _ 


Current Becord Pointer (CURRENT) 


The CURRENT is a structure that» for ANSI "74& CGB8OL» logicaity 
belongs in the User Specific Information Fieid» since there is 
only one CURRENT per user. There are two reasons for associating 
the CURRENT with the Structure Oescriptor» however. Firsts» ONS 
has a CURRENT for each structure and a pointer exists in each STR 
to the appropriate CURRENT. To be compatible with OMS» each STR 
of an Indexed Sequential file points to the CURRENT for that 
structure. A current structure number is maintained ir the USI 
to satisfy ANSI *74 requirements. Second» since the file can be 
shared» an operation by one user can affect the CURRENT of 
another user. To guard against this» each CURRENT is checked 
when an operation which can affect it is perfor wed. To aid the 
search of CURRENTs» they are Linked togethers the first one being 
pointed to by the STR» <A programmatic description of the CURRENT 
field is presented below. 
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OL CURRENT DECLARATION» 
02 CUR.LINK BITC24)>- 
02 CUR. JOB. INVOKE» 
03 CUR»CUR.J0B | BITCi6b)» 
03 CUR-CUR.AINVOKE BIT(6d> 
02 CUR.STATUS BIT(2)>» % O-DEL» L-VAL 
92 CURFINE~TASLE» 
O03 CURAAREA BIT{3)» 
O03 CURjBLOCK BITC16)- 
03 CUR.RECORD BITCi2d»> | 
G2 CURSSTATISTICS» s 
03 CURASTR»READ»COUNT BITC24)>» 
O03 CUR*STR»WRITE.COUNT BIT(24)>» 
03 CURSSTReAREWRITE »COUNT BITC24)> 
O03 CUR.STR»DELETE.COUNT BIT(24)» 
03 CURs*STReSPECIAL.COUNT BLiT(24)>» 
O03 CUR.STRAEXCEPTION.~COQUNT BITC24)>» 
O03 CUR~ASTR»~PHY»READ»COUNT BIT{24)>» 
03 CUR~STRePHY WRITE .COUNT Bit({24);7 


CURRENT Saintenance 


The current is maintained for Indexed Sequential files which use 
either Sequential access or Dynamic access. When the user is 
accessing the file sequentialiy» the current is maintained for 
the key of reference CUS1.~CURRENT.STRUCTURE). For output files» 
the key of reference must be the orime key and CURRENT always 
points to the last entry written. For a new filee CURRENT is 
initialized to point to the first entry but CUR.STATUS is set to 
indicate the entry has not yet been written. For an oid file 
opened GUTPUT EXTEN the current is initiatized to the tast 
entry written. The Micro MCP uses the current on output fites to 
insure that records are written in sequence» a requirement of 
ANSI 74 CCS80L. 


Sequentiad INPUT or INPUT-OUTPUT files require that the current 
points to the tast record read. On the next READ operations the 
current is incremented to point to the next availabie record. If 
the current record is deleted or the CURRENT was positioned by an 
OPEN or START» then CUR.STATUS is seat to indicate that a record 
has not yet been read. The next. READ witd dediver the record and 
reset CURSTATUS. 


For fiies in Dynamic access mode» the meaning of CURRENT is more 
complicated. The CURRENT witt be handted exactiy as in the casa 
of Sequentiat INPUT or INPUT-OUTPUT. This means that soe 
sequences of operations may not produce the desired intuitive 
resudit. The exampie betow iilustrates the probles. 
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Consider the Endex table at the right. Sa eliealeated 2 
What should the resutt of .a READ NEXT i =6ABLE i 

be» in the fodtowing sequence of operations? i bOG { 

4 GOLF i 

ae READCABLED» ADDCBAKER)» READ NEXTS fret ere nensy 


be. READCDGG)» DELETEC DOG)» ADDCECHO)» READ NEXT> 
Ce READC DOG)» DELETEC DOG)» ADDX{ CHARLIE)» REAG NEXT; 


For our implementation the READ NEXT produces the fodtlowing 
results: 

ae BAKER 

b. GOLF 

c» GOLF 


Indexed Sequential Buffer Management 


The method of aliocating buffers in prior versions of the NCP and 
in the 9.0 version for Conventional files is known as Static 
allocation. This method of allocating buffers is simple» once 
the number of buffers has been chosen by the user. The buffers 
are merely atlocated when the fila is opened and they remain 
assigned to the file until it is closed. if the number of 
buffers allocated is too smait» however» then operations upon the 
file may be inefficient. If the number of buffers aiflocated is 
too targa» then nothing is gained in efficency and memory space 
is wasted. . 


On an Indexed Sequential file particularly, the nuaber af buffers 
actualiy needed varies with the type of oneration and the state 
of the Indexed Sequentiadt file. The optimum number of ocuffers its 
best chosen dynamicadty to avoid the disadvantages sentionad 
above. ee 


Adilocating buffers on demand and deattlocating them when the 
memory they occupy is required for other ourposes is Known as 
Dynamic adiocation. Dynamic allocation has aiways been used for 
buffers associated with a OMS data base. It is accomplished by 
cadl@ing the MCP*s memory atiiocation procedures GETSPACE» whenever 
a buffer is required. Dealtocation as accomplished by attowing 
GETSPACE to overdiay ONS buffers when necessary. Dynamic 
aldocation has aiso heen implemented for Indexed Seauertiat 
files. 


The management of buffers associated with an Indexed Sequertial 
file presents a speciai problem for the MCPs» since there can be a 
variable number of them» depending upon the operations and they 
can be different sizes» depending upon which component file is 
being accessed. To solve the problems associated with a véeriabie 
number of buffers» the Prioritized Memory Management algorithms 
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developed for the 7.20 release shouid be used. This memory 
manager oavertays buffers whenever space is needed and the 
priority of a buffer makes it a candidate to be overtaid. The 


FIFO Memory Management aigoriths can be used but performarce may 
be impacted on a @ulti-programming system. 


To solve the probdems associated with variabte size buffers 
addressing the same Indexed Sequentiad file» ait of the buffers 
used for one structure are linked together and pointed to by the 
structures» so that adi buffers in a chain are of the sane size. 


indexed Sequential Buffer Qescriptor (902 


The Buffer Descriptor is the structure used to maintain the 
buffers associated with the Indexed Sequential files it contains 
the necessary tink fields» identification fields» and state 
information. Since the memory manager may overtay the first 
buffer in a chain» the memory tink field» ML.POINTER> wilt 
contain the structure address so that STR»eBUFFERLIST.POINTER may 
be updated. A programmatic description of the Buffer Descrioter 
is presented betow. 


O1 BUFFER _CESCRIPTOR» 
02 AN Si ela 


03 §8D.AREA . BIT{LB de 

03 8D.0F FSET BIT{1L6)> 
02 BDAUSER~»COUNT BITC4)>» 
O02 BDeIN.~MEMORY ove ~~ BITC1)>» 
O2 8D~10.ERROR BITC1d» 
O02 BO»eAWRITER~CONTROL» | 

03 BOeREQUIRESAWRITE BITCL)» 

03 8D.CONTROL~POINT BIT¢1)>» 
92 BDeNEXT.BUFFER~BDESCRIPTOR BIT(24)> 
92 BD»aAPRIOR»BUFFER.DESCRIPTOR BITC 24)3 


I/0 descriptors are shared among adi the buffers. The BEGIN and 
END addresses in the descriptors may be modified when a 


descriptor is used by. the Operating System. The number of 
buffers aliocated depends on the number of active structures 
associated with the Indexed Sequentiai fite. This technt que 


serves to minimize the number of descriptors in the disk chain»s 
thus reducing the amount of processing required by GISMQs» and it 
minimizes the memory requirements for descrirtors. It does 
require an allocation mechanism for descriotors» in addition to 
one for buffers» but this expense has been found to be worth the 
benefits. 
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Concurcent Update Qoerations 


Concurrent READ operations on the same record of an Indexed 
sequential file are always ald owed. For the 9.0 version of the 
softwares ald togical update operations» WRITE and REWRITE» wit 
be started onty after alt accesses to the file have been 
suspended. These update operations witli inhibit further accesses 
to the file untid they complete... To users» it wiit appear that 
concurrent updates to the file are allowed» theuch this wilt not 
actualdy be the case. 


This restriction simplifies the code necessary to insure that the 


appropriate buffers remain in memory. Since oniy one update 
operation can be in process at any given time» the update 
operation will begin with a 8D.USER~COUNT of zero. Once the 


update operation uses a buffer» that buffer‘s user count will be 


Set to one» thus preventing tha Memory Management atgoritha from 
overtaying it. = ~~ 


Upon completion of the update operation att user counts wilt be 
set to zero. For READ operations» the user count field is not 
used because each buffer need he used only once during the 
process of the communicate. The buffer is automaticaity 
protected from being overlaid while the [70 operation is in 
process. 


The code necessary to insure the integrity of the file is atso 
simplified. The Record Contention problemse the complex probieas 
involving changes to the file while another user is accessing itr 
are avoided. For the simple case of one user at a time updating 
the filer The simplified code provides better performance. 


Disk i209 Ecror Procedures 


The disk I/0 error procedures in the MCP perform a certain number 
of retry operations each time a disk [/0 operation completes with 
the Exception Bit» Bit 2 starting from zerca,r set to one. 
Different procedures may be invoked» depending upan the type of 
I/0 operatien that has completed and the type of controt and 
drive that encountered the error. MCP I/0 operations are handied 
by a different procedure which is not as extensive as the one 
described betow. The following description applies to I/0 errors 
on user I/70 operations only. 


The [7/0 error procedure first checks the Memory Parity Error bit, 
Bit 5 ain the Result Descriptors received from the controid. If 
the bit is one 3t performs a maximum of three retry operations» 
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legs the result and exits the procedures without investigating 
any other bits in the resuit descriptor. 


The procedure next checks the Transmission Parity Error bit» Bit 
15 in the resutt descriptor. If this bit is on and if the unit 
being used is not a 89482 disk cartridges the procedure performs 
a maximum of three retry operationse togs the resuit and exits 
the procedure without checking any further. lf the unit is a 
B9482> no retry operations are performed for this case but and 
the investigation continues.« 


The procedure next checks the Not Ready bite Bit 2 in the resuit 
descriptor. If this bit is on» the procedure performs a faximun 
of three retry operations» logs the result and exits the 
procedure without checking any further. . 


The procedure next checks the Write Lockout bit» Bit 6 in the 
resudt descriptor. If this bit is on» The procedure tooks at the 
If70 descriptor itself. If the first three bits of the operation 
code are 010» O11 of 101% which would denote Write» Initiatize 
and Reisocate» the procedure performs a maximum of three retry 
operations» togs the result and exits the procedure without 
checking further. If the first three bits denote sorething other 
than the three operations listed» Bit 6 is ignored ard the 
investigation continues. 


The procedure next performs a Logical OR operation on: 


le The Sector Address Error bit» Bit 10+ 

2 The Seek Timeout bit» Bit. Lis 

3. (The Address Parity bit» Bit 9» AND not 89482)» and 
4. The Data Error bit» Bit 3. 


If the result of the Logicat OR operation is truer the procedure 
becomes compiex and varies with the type of disk connected. 
Before describing the procedure for each type of disk» some basic 
procedures should be described. 


The Offset Procedure 


The Offset Procedure is a subroutine of the disk I/70 Error 
procedure. Basicaily» it performs six retry operations. If any 
ene of the six effect recovery of the errors the procedure is 
exited immediately regardiess of how many operations have heen 
performed. The term “offset™ as used here denotes positioning 
the disk heads slightly off of the center of the cylinder 
specified in the disk address. In aii disk pack drives which may 
be connected to the 81000 system» offset may be specified in the 
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inward (positive) or outward (negative) direction. 


The first two operations requested by the Offset Procedure are 
performed with the original 1/70 descriptor unmodifiad. The next 
two operations are performed with negative offset and the tast 
two are performed with positive offset. If recovery is not 
effected by any of the six» alt bits which may have been set in 
the originat I/9 descriptor to cause the offset operations are 
reset and the procedure is exited. 


ihe Strobe Procedure 


The tera "strobe" as used here denotes beginning the actual read 
operation sfigtily before. or after the point in the rotation of 
the disk where it would normalty begin. The Strobe Procedure 
calis the Offset Procedure a maximun of three times. This may 
cause a maximum of eighteen retry operations to be performed. If 
any one of the eighteen effect recovery» the procedures is exited 
regardless of how many operations have been performed. 


The first calf on the Offset Procedure is accomplished with the 
original [/0 descriptor in its unmodified fora. This will cause 
six retry operations to occurs exactiy as described for tha 
Offset Procedures provided recovery is not effected by any of the 
Si X« The next cadi is accompiished with a bit set in the 
descriptor which will cause early strobe toa occur. Hence» 
another six retry operations may be performed two with earty 
stfobe and no offsetr two with early strobe and positive offset 
and two with eariy strobe and negative offset. 


Twelve retry operations have been performed to this point. Cf 
the error has not yet been correcteds the Offset Procedure is 
again cadted with bits set in the I/0 descriptor to cause tate 
strobe to occur. This may result in another six retry operations 
being performed» as described for the Offset Procedure» ati with 
bits set in the I[/0 descriptor to cause fate strabing to occur. 


If none of these eighteen operations effect recovaryr, ail bits 
which may have been set in the I[/09 descriptor are reset ard the 
procedure is exited. In the Strobe Procedure and in the Offset 
Procedures if any retry operation does effect recoverye the I[/06 
descriptor resposibie is entered tin the log prior to exiting the 
Procedura. 
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Ihe Erroc Correction Procedure 


All varieties of disk pack that may be connected to the 981006 
system and some varieties of disk cartridge include error 
correcting capabilites in the form of a Fire Code rernainder 
stored immediately after the 2440-bit data segment. The 
remainder is fiftyssix bits in tength on the 207 disk pack and 
thirty-two bits in tength on all others. It is computed and 
stored by the disk harduare when the data segment is written. If 
an error should occur when the data segment is read» the data as 
it should have been written may be raeconstructeds> provided ali of 
the bits in the data that are incorrect reside in the sate 
“burst” of bits and provided the length of this burst does not 
exceed a specified dimiting number of bits. 


The Error Correction Procedure obtains a 29080-bit buffer fron 
avaidabie memory. If such mesory 35 not avaiiabler the routine 
exits without attespting to correct the error. In ait cases» 
when error correction is performad» ald of the segments described 
by the original descriptor are read and corrected one sector at a 
time. For aid disk devices which store the 32-bit remainder but 
which de not have the ability to correct burst errors in input 
data» the procedure must operate in this manner. Devices which 
are capabie of performing error. corrections — such as the 207 disk 
drive» are capable of doing s0 on muitipile-sector read 
operationse but this feature is not utilized by the software. 
Rather» att of the sectors are.read one sector per operation and 
the exact addresses of adi ‘failed sectors are togged. This 
information would be tost on a tudtipile-sector read operation. 


Error correction is performed by the software for all varieties 
of disk pack except the 207. $=The 207 hardware includes error 
correcting capabilities. Error correction is also performed by 
the software for the 89482 Disk Cartridge. The software is 
capable of correcting a six“bit arror burst. The 207 hardware is 
capable of correcting an elevenwbit burst. — 


Data and Address Error Recovery = 213 And 222 Qrives 


Two different varieties of 215 and 225 disk pack drives have heen 
delivered during the life of the 81000 hardware. These varieti¢s 
are known as Design Level One (9L"1) and Design Levelt Two (0L72). 
For both varieties» the Strobe Procedure is invoked but there are 
some operational differences in tha hardware. itself. Qn Di-1t 
drives» the bits which cause plus and minus offset and early and 
fate strobing are ignored by the hardware» since it does nat 
include these capabilities. Consequentiy» on DOL°*1 drives» a 
total of up to eighteen retry operations wiii be performed by the 
Strobe Procedures but they witd actuality be nothing more than 


gn BS 


BURRGUGHS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP Bi009 MCP II 
SANTA BARBARA PLANT PeSe 2212 5462 (FE) 


eighteen repetitions of the original I/70 descriptor. DL<-2 drives 
include a fulf compiement of offset and strobe capabilities. The 
software cannot distinguish between the two types of drive. 


If none of the eighteen ratry operations caused by the Strobe 
Procedure effect recovery» the I70 descriptor is restored to its 
originat state» and the Error Correction Procedure is inveked. 
Each segment described by the [70 descriptor is read individuaity 
and error correction is performede if possible by the software. 
In all cases» the resuits of the recovery attempt are entered in 
the Engineering Log. 


Qata and Address Error Becovery = 205 And 296 Orives 


For 205 and 206 disk drives» the Strobe Procedure is performed 
exactly as it is described. Eiqhteen retry operations are 
performed» two operations with each possible combination of tha 
strobe and offset variants. If any of these operations effect 
recover yer the I/0 descriptor is restored to its originat 
condition and the procedure is exited. lf not» the Error 
Correction Procedure is invoked with the I/0 descriptor in its 
original condition. Error correction is performed by the 
software for 205 and 206 drives. 


In any casee the resuits of the recovery attempt witt be enterad 
in the Engineering Log prior to exiting the procedure. The 170 
descriptor is adways restored to its originat cendition prior toe 
exiting the procedure. 


Data and Address Error Becovery = 2027 Orives 


207 disk drives include neither: offset capabidities nor strobe 
capabilities. The hardware does include a capabidty to vary the 
threshold of a read operation but its use is not recommended for 
recovery purposes by the manufacturing plant. “Consequentiyer the 
Strobe Procedure is not invoked for 207 drives. Two retry 
operations only are performed» both using the original version o 
the [/0 descriptor. [If either operation effects recovery» the 
resudts are lagged and the procedure is exited. if not» the 
Error Correction Procedure is invoked. 


207 drives include error correcting: capabilities in the hardware. 
Additionally» the hardware is capable of correcting ali errors 
that are correctable in alt sectors described in one *muitipnte 
sector operation. This multipie sector capability is not 
utilized by the software» howeveres and each sector is read and 
corrected individuadily. This ais done for diagnostic purposes 
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only» to isolate the address of the failed sector(s) and insure 
their entry in the Engineering Log. The resuits of the recovery 
attempt wild be dogged and the procedure witli be exited with the 
i/0 descriptor restored to its original condition. 


Bata and Address Error Recovery = Disk Cartridges 


For alt versions of disk cartridge except the 89482» the 4400 
BPi» 203 of 406 track» 64 sector per track variety of cartridge» 
the error recovery procedures are very simple. The procedure 
merely repeats the original operation a maximum of three times. 
The resuits of this attempt are toggead and the procedure is 
exited with no further checking. There are ro other options 
avaitable in the hardware which might haip in the recovery 
attempt. 


For the 89482 cartridge» the recovery attampt is slightly sore 
extensive. This drive has error correcting capabitities sisitar 
to those of the 206 driva. Error correction on 2a Read operation 
13 performed by the softwara in the Error Correction Procedure 
exactly as it is described. On a Write operatione the recovery 
attempt is actuadily more complex than for a disk pack. 


When a Write error occurs on the 389482 cartridger the I/0 Error 
procedure wilt attempt to correct the errore if the three retry 
operations mentioned above faile by writing the data one secter 
per operation. In the case of an Address Parity error» the 
procedure witli also attempt to write that sector ptus the 
preceeding sector in an effort to correct the address parity. 
The resuits of the attempt will be logged and the procaditre wit 
be exited when recovery is effected or when add retry attempts 
have been compieted. — 


This concludes the discussion of Data and Address Error Recovery 
for the various drives that may be connect. The remainder of 
this section describes the remaining tests in the I/0 Errar 
procedure. 


Remainder of the Disk 170 Ecror Procedure 


If the results of the Logical OR operation mentioned previousty 
were false» the 1/0 Error procedure examines Bits 22 and 23 of 
the resuit descriptor. If both bits are set to ones they 
indicate that an Extended Resuit Descriptor was returned with the 
operations though the ERD may not be stored in memory. The 
procedure stores the Extanded Result Descriptors if it ts 
avaitabie» in the Engineering Log and performs a maximus of three 
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retry operations using the original 1/70 descriptor. The resuits 


of the attempt are togged and the procedure is exited with no 
further checking. 


Finatty» aif adi of the tests mentioned to this point ware false» 
the procedure performs a maximum of three retry operations and 
logs the results. Since an exception did occurs indicated by the 
setting of Bit i» the data is assumed to be corrupt and an 
attempt is made to correct ite | 


dJage 170 Eccor Procedures 


There is one 1/0 Error procedure that is invoked for alt tape I/0 
operations that compiete with the Exception bit in the resutt 
descriptor set. The procedure is invoked regardless of whether 
the operation was a user 170 or an MCP I/70. It is aiso invoked 
on the completion of Test operationss where the setting of the 
Excepton bit is a normal occurrences It is aiso invoked for 
Emudator Tape operations» though in this case» it may do nothing 
more than pass the resuit descriptor on to the user (for 
resolution. 


Essentiaity» the procedure wild retry the operation a fixed 
number of times and return controi to the procedure which cattied 
ite If recovery was effectad> this wiid be so indicated in the 
previously failed result descriptor upon return. Lf the 
procedure was not able to eaffact racoveryrs the resuit descriptor 
widid contain an indication of the failure upon return. In most 
instances» the procedure witti retry the operation ten times» but 
this number witil vary with the type of failure and the operation 
attempted. 


The Tape I/0 Error procedures wilt be described fully in a 
subsequent version of this specification. 
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SIMEMORY MANAGEMENT AND MEMORY REQUIREMENTS 


This section of the specification has two principte parts. 
S"menmory Management is described at the functionat tevel. 
S“memory requirements for a given system configuration are then 
presented. Using the second part of this sections it shcuid he 
possibile to estimate the amount of S-menory that Wild be required 
on a system to support a given program. 


S“memory management techniques were changed drasticaliy in the 
7.0 varsion of the software and were changed again in the 9-1 
versione The discussion cantained in the first part cf this 
section pay not be appticabler in all cases» to versions of the 
software reteased prior to tha 9.1 version. 


GENERAL MEMORY MANAGEMENT CONCEPTS 


The 81000 software utilizes a “segmentation” form of memory 
management. In such a systems memory is requested and aiteccated 
only when it is required and only in the amount that will exactly 
satisfy the request. In other words» memory is divided into 4 
variabie number of segments» each of which is of any sizer with 
some obvious restrictions. A basic edamant in this forma of 
memory Management is the "memory Link*™. 


The format of the memory Link was presented in a prior section. 
Basicald y» it contains a size fietd which aay contain any vatue 
from zero to 1607772215 bits. It contains the addresses of the 
memory @inks that precede and sucteed it and the address of an 
associated segment dictionary entry. ‘It contains a nusber cf 
other fields» which widd bea discussed in turn. It is created and 
maintained by the MCP and the. executing interpreters store 
selected information in it. In ati cases» it imnediatety 
precedes the segment of memory that it describes. 


LIQKEO MEMORY 


Contiguous blocks of memory are reserved for system use at the 
extreme ends of the memory on any Sy Stome : This. is described in 
more detail in the second part of this sections Between the tro 
contiguous blocks ilies the area known as “Linked memory". At the 
end of the reserved area at the low end of memoryr there is a 
dummy mermory tink known as the Lower Terminating Memory Link 
CLIML). At the beginning of the reserved area at the upper end 
of memory is the Upper Terminating Nemory Link CUTML). 
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The terminating memory links are created during the Clear/Start 
procedure. Each has a size field of zero» a type fteld which 
specifies the area as TERMINATINGsLINK» but the "save" bit wilt 
be set to one in both tinks. This allows the memory managesent 
procedures to recognize the terminating memory tinks. The 
backward pointer ain the LIML wild contain @FFFFFF a; but the 
forward pointer will contain the address of the next memory link, 
in address order. Similarity» the backward pointer in the UTML 
wilt contain the address of the previous memory link in address 
order? the forward pointer will contain aFFFFFF a. 


Hences aad memory Links form a chain in memory. The memory Link 
which immediately precedes each atliocated memory area witi 
contain the address of the succeeding and preceding memory tinks 
in the forward and backward pointer field respectively. The 
chain wilt be terminated in the forward direction by the upper 
terminating memory Link and in the backward direction by the 
lower terminating memory tink. 


The area known as tinked memory is an exagpie of a “memory 


subspace“» as this term is used herein.» There may be other 
memory subspaces withir tinked memory. The Run Structure 
(Base/Lisit area) of certain programs may aisso be divided ard 
allocated upon request by the software. The same precedures in 


the software are used to manage these smailer memory subspaces as 
are used to manage Linked memory. 


IYPES OF MERORY REQUESTS 


Memory requests may originate in a number of diverse manner $s. 
This is evidenced by the darge number of different values the 
type field of a memory tink may contain. The most common 
occurrence of a memory request is for a code segment to he 
brought into memory. Other requests originate when a file is 
opened» when the MCP needs additionai temporary storage for the 
performance of one of its tasks» when additional space is 
required to hotd a queue messager and so forth. 


There is probably no need to discuss each different type of 
memory requeste Many of the numbers assigned to each differant 
type of memory request are for the benefit of the Duso/Anatyzer 
program oniy and have only pathodtogicait use. The different types 
of requests have common characteristics and may hence be grouped 
into “classes”. The common characteristics widl be described and 
explained. 
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Parameters that are passed with a memory request are the size of 
the required semory ares in bitsr the address of the dictionary 
entry which will be associated with the memory areas if anys» the 
address of the Run Structure Nucleus of the orogram which caused 
the requests if any» the type field to be stored in the memory 
Links the oriority of the requests a boolean variable which 
specifies that the memory should be adliocated at the highest 
possible ohysicat address and a bootean which specifies that the 
memory must be adlocated above the "fence". 


JHE FENCE 
The NCP has one set of stacks» onty» to store the variables that 
it must manipudate in the performance of any function. This set 
ef stacks cannot be stored anywhere elise; they must be 


maintained in wtemory until the function has been performed. 
Consequentiyr onca the MCP begins performing any functions it can 
perform no other function until the original task is compiete. 


Admost ali MCP Functions require more than one MCP code segment 
to complete. A faite Open may require more than thirty code 
segments to be brought into memory. The number of code segments 
required coutd obviousty be reduced by making each code segment 
larger but this would atso reduce the possibitity of finding 
sufficient memory on smaid systams. It would aiso possibly cause 
more user code segments to be removed from memory to make roon 
for the darger MCP segment. 


Shouid the MCP begin performing a certain request and not be able 
to find sufficient memory to contain a necessary code segment» 


the system woutd have toa hait. A Clear/Start woutd then be 
required» with ats resulting toss of ati programs that were 
running at the time. In order to insure that there wit atways 


be sufficient memory to bring in the targest MCP code segments a 
fence is astablished in memorye below which only code segments 
are atltowed to reside. The Location of the fence may be 
calculated by adding the size of the largest MCP code segment and 
its associated segment dictionary to the address of the lower 
terminating memory Linke ; 


Certain exceptions to the statements in the paragraph above 


exist. Code segments way not be overiayable at all times. To 
bring a code segment into memory» the memory area is aitocated 
and an I/G operation initiated. The memory area may not be 


deattlocated untit the I/0 operation is complete. Should the MCP 
encounter such a situation and not be able to find a required 
memory area anywhere elise in Memory,» at wilt wait for the 
comptetion of the operation. 
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Certain code segments associated with MICR applications programs 
are atso not overitayabie. This is atso true of segments of the 
interpreter used by such programs. Consegquentiys the fact that a 
memory request is for 4a code segment is not sufficient to 
determine whether the memory shoutd be aldiocated betow the fence 
and the boolean variable is required. 


MINIMIZATION O£ "CHECKERBOARDING™ 


Checkerboarding» aso known as External Fragmentation» is the 
condition which exists when memory contains a targe nusber cf 
permanentiy-atilocated areas» or “save™ areas» most of which are 
separated by smaid overtayable areas. In such a situations the 
totad memory available may well be large enough to satisfy a 
given request but no single contiguous overlayable area is 
sufficiently large. This situation can have a serious impact 
upon per formance. 


To minimize the possibility of the occurrence of checkerbcardings 
the NCP attempts to aitlocate ail memory denoted as 
nonsovertayable or “save™ at the highest possible physical 
address. Examples of items which are so aliocated are program 
run structures» files and 170 buffer areas. 


MECTIN SELECTION 


When a request for memory aliocation is receivede the management 
algorithm must select a “victim"» a portion of memory which is 
already aitocated which may be deatiocated and assigned to 
satisfy the new request. The area to be altocated may aisa he 
marked Availabtes of coursere though this is seidom the case. 
"Victim Sedection”™ is the process of determining which adiocated 
memory segment or segments will ba deadilocated. This is the most 


intricate task of the management atgorithm» the task which 
requires the most attention to strategy and the task which is 
most influential upon the performance of the system. Two victis 


sedection algorithms are provided in the software. Users may 
choose sither the priority Victim Selactor or the Second Chance 
Victim Setector via ai systew option. The change is onty 
effeccted during a Clear/Strat operation. 
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ROUND-ROBIN VIGIIN SELECTION 


Prior te the 7.0 release» victin selection was eassentiatiy a 
round-robin among requests. The MCP kept a pointer which served 
as the starting point of each search and was updated after aach 
attocation to point to the end of the newly allocated area» This 
pointer is typicadiy referred to as the *"deft-off pointer”. The 
round-robin algorithm had the advantages of being coaputationaity 
simpie and it served to minimize external fragmentation» but 
there are some serious disadvantages associated with this victi«e 
selection algorithm. Specificaliys 


ie It has no knowledge of which segments are actuality in use» 
elements of the “working set"» and 


2» The memory resources of each job have equal importance. 
Uniike processor scheduling»s the memory is not atlocated on a 
OOhrs? basiSe 


These flaws lead to some bad per formance degradations in certain 
Situations. One such problems is the “cascading” phenomenon. 


Using Denning*s definitions a orogram*s working set WUT» t) is 
the set of aii segments accessed by the orograr in the irtervat 
{¥I-t» T]. Denote the size of this set Cin MCPII context» size is 
in bits)» as W(Tr t). This definition affords us useful 
information with which to manage real store whenever the change 
C"drift™) from the set WOCTO» t) to the seat WitTi» t) ti: smatt 
for the interval £710» Ti}. The assumption behind working set 
management is that for many programs» the drift is indeed smailt 
during most of their execution Lifetimes. 


Postulate a situation where the code and dictionary segments of a 
Single job completety fild overtayable memory. The round-robin 
algorithm» having no information concerning WUT» t) made a choice 
of victims among the resident segments which was essentiadty 
random with respect to this information. Cait the ratio 
WOT» to/Csize of overtayable ‘memory? the saturation ratio S.. 
Then the probability is approximatety. §& that the incoming segment. 
wid overlay one or more elements of WKT» tt). The overdlayed 
segments of courses will immediately be needed again and has a 
probability of about 3 of overlaying another element of WUT» t). 
This sets up an undesirable oscildation which should eventuadiy 
damp back to stability. assuming no further externat 
perturbances. The probable number of extra overtays required to 
reach stability increases with S» and becomes quite targe when § 
exceeds» saye 0.29. We cali this oscillation “cascading” of 
overlays. For farge vaiues of S» aimost ali time is consumed in 
waiting for I/0 on the backing store» so very Little work gets 
donee This is the situation comtonty known as “thrashing” 
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Now» suppose the memory manager has some knowledge of the 
elements of W{T» t). if the saturation ratio is not too close to 
ones it wild usually be possible to seiect a window containing no 
element of WiT» t). The chance of cascading segments is therety 
decreased in configurations running with 5S in the range of 0-5 to 
0.75% The difficulty is that elements of WET» t) now clutter 
@emory and increase external fragmentation. As 3S approaches Cer 
exceeds) ones this becomes an important Loss and makes selection 
difficult for the memory manager - At this points the advantages 
of the round-robin strategy begin to outweigh the advantages of 
utilizing working set information. 


WORKING SET DETERMINATION 


in order to determine whether or not a code seqrent in sewory is 
currently being used» usage bits were added to the memory Link in 
the 729 version of the software. These appear in tha 
programmatic description . of the memory Link as 
ML»~PREVIQUS.SCAN.~TOUCH and ML.CURRENT.~SCAN.~TOUCH. Whenever an 
interprater accesses a code segment dictionary entry and = finds 
the associated code segment present in wtemoryre it sets the 
current scan touch bit to a value of one. Interpreters make such 
an access whenever they are reinstated and whenever a code 
segment transition occurs. It is not necessary for interpreters 
to set the bit in memory Links which are associated with segment 
dictionaries. These are usuatiy marked as save space if any cf 
their code segments are present in memory. Also» data segwents 
are always overtaid in a roundsrobin fashion» regardiess of the 
victim selector that is currantty being used on a system. 


SECOND CHANCE VICTIN SELECTION 


The Second Chance victim selection aigortihes: first introduced in 
the 9.1 version of the MCP» addresses the first failing of tha 
round-robin aigorithm» the tack of knowledge of the working set 


of the code being used. Also» the Second Chance atgoritha 
compietedy supplants the old round-robin strategy The latter is 
no donger avaitable for use. The change is compietely 


transparent to users and the onty noticeable effect should be an 
improvement in performance in installations where the round-robin 
algorithm was used prior to release of the 9.1 software. 


The Second Chance aigorithm utilizes the teft-off pointer 
described for the round-robin algorithm. It begins searching for 
a memory space targe enough to satisfy the request at the 
left-off pointer but it will not select any space whose touch 
bits ML»aACURRENT.SCAN~TGUCH» ais set. Upon encountering a memory 
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segment whose touch bit is set» it resets tha bit and continues 
to the next memory tink. It wild allocate the first segment it 
encounters that is sufficiently large and whose touch bit is 
resets ‘ 


This atgorithm thus has the major advantage of the round-robin 
al gorithm; it ais computationaliy simple and the procesing 
required is minimized. Undike the Prioritized victim setection 
algorithm described below» it requires no knowledge or action on 
the part of the user. 


PRLORITY VICTIM SELECTION 


The second failing in the round*robin strategy is its inability 
to insure rapid turnaround to jobs which are designated as high 
priority. In MCPII» prior to the 7.9 release» anly the processor 


was aitocated on the basis of opriority. A high priority 
appiication was contending for the memory rasource on exactty the 
same footing as a tow priority “background” job. This died to 


severe performance degradation for users which required many 
overlayable mewory resources but frequently relinquished 
processor control to make operating system requests. In 
particular» datacomm applications running in muitiple jot shops 
were suffering badiy. Background jobs tended to usurp critical 
resources forcing the datacomm apptication to doose controt still 
more frequently» atiowing background jobs to runes grab more 
memory resources» and so forth. 


The Prioritized memory management algorithms first introduced in 
the 7.0 version of the MCP» addresses both of these problens. 
The priority victim selector makes its choices on the basis of a 
priority field in each memory Link. This field is maintained by 
runtime use of working set inforsation.» The priority fietd witl 
be maintained at its originat vaiue as tong as the code segment 
is not used.» This field is known as the Residence Priority fieid 
and is shown on the orograamatic memory Link description as 
ML eRESTDENCE.PRIGRITY. 


Associated with each program running on the system is a Memory 
Priority field. The memory priority vatue determines the ability 
of the program*s code segments to overlay the code segments of 
other programs running on the system. Memory Priority is stored 
in each memory Link associated with each of the program's code 
segments» It is shown programnaticaliy as ML~INCOMING.PRIGRITY. 
Memory priority is also stored initially in the Restdence 
Priority fieid. Whenever a raquest for a new code segsent to he 
brought into memory is received» the memory priority of the 
associated program is compared to the residence priority of every 
wemory fink currently present in the system memory. The current 
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impdementation of the victim selector always chooses a victin 
having the lowest residence priority. 


An exception must be made for MCP code segments. AS presented in 


a orior paragraphs the MCP cannot be denied a requested code 
overlay without halting the system. Consequently» MCP code 
segments have an imperative incoming oriority» but their 


residence priority value witt decay at a rate equai to or greater 
than thea programs running on the system. 


At a user-specified interval» a routine in GISMO known as the 
Sweeper is executed. This routine moves the setting of the 
current touch bit to the previous touch bit» destroying the pricr 
setting of the previous bit and setting the value of the current 
touch bit to zeroe This routine is discardable and is etiminated 
by the initializer if the system is running with the Second 
Chance victim selector. : 


The defauit time period between executions of the sweeper is 865 
middiseconds. Users may vary this time period via a ka@ybdoard 
instruction within certain rangas. Since the sweeper routine may 
be executed between any two Soperations»s ali code in the 
software which manipulates memory Links gust aiways insure that 
the chain formed by the address pointer fields is intact. 


After the sweeper has moved the current touch bit to the previous 
touch bit» it then examines the previous touch bit. If the vatue 
is zeros it increments the current decay intervai fieid- 
ML eCURRENT.OK.INT> by the vatue of the sweep interval. If the 
value of the current decay interval is equat to or greater than 
the specified decay inteval-» ML»OKAINTERVAL » the residence 
priority field is decremented.» | 


The defautt vatue of the specified decay intervai is zero. Users 
may specify different decay interval values via a keyboard 
instruction. Users may atso specify that certain code segments 
within a program are important and thdt their residence priority 
should mot decay until the specified decay interval has elapsed. 
This és accomplished via a supplied normai-state prograr which 
manipulates code files resident on disk. The residence priority 
of code segments which are not marked as important witd decay 
after the default decay interval» zero seconds» has elapsed. 
Notices however» that this cannot occur for at teast one sweep 
interval. a ee: | | 


When executing with the priority victim selectors» the MCP stild 
maintains a left~off pointer. When the system is thrashings when 
the residence priority fields of all memory ftinks have eauail 
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values» the victin selected wit continue to be the next memory 


area below the Left-off pointer. 


PROGRAMMATIC DETECTION GE MEMORY THRASHING 


One of the serious probiems confronting virtuat storage systems 
is memory thrashing. On the 81000 system» memory thrashing 
occurs when the working set of procedures fora program or set of 
programs witli not fit within the portion of asain memory availadte 
for overtays» When this state occurs» the system*s performance 
begins to degrade. The amount of degradation depends on the 
overday space availabie> the size and number of segments 
competing for memory» and the frequency of segment transitions. 


As the amount of main w®emory is reduced for a constant 
programming task» ‘the amount of degradation due to memory 
overlays normality appears very gradual at first. As the 
available memory is further reduced» a point wilt be reached 
where the degradation due to overlays increases rapidiy. This is 
the point where the main working set of procedures no tongar fit 
in main memory and are competing for space. This point is 
defined as the thrashing point and is shown in Figure 4.1. 
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As seen in Figure 401+ execution of the programming task with 
less memory than indicated by the thrashing point yields 
inefficient execution times in region Aw 


Beginning with the 7.0 version of the softwares the MCP inciudes 
a programmatic facitity for detecting a thrashing condition in 
the system. The facility is included in GISMG as a discardable 
seagment; it is retained or discarded during the Ciear/Start 
operation based upon the setting of a system option. It may be 
used with either victim selection al gorithm. It must be used if 
the priority victim selection at gorithm is used. 


The facitity is actuated by a clock maintained in the software. 
It utidizes a count of the number of overiay operations performed 
by the software. The count is aiso maintained in the softwarer 
of course. The sweeper routine discussed preaviousty is actuated 
by the same clock that actuates the thrashing detection routine. 


At a user-selected interval» the thrashing detector compares the 
nugaber of overlays which occurred during the intervai to a 
user-specified target number of overlays. if the overtay target 
is exceeded» the thrashing detector suspends tesporarily the 
execution of the sweeper routine and begins a count of the number 
of consecutive intervats during which the number of overiays 
exceeds the target number. The ald@owable number of intervats 
during which thrashing» as defined by the usere is detected is 
three. 


If the thrashing condition persists for three intervais»s the 
software informs the operator via a SPQ message. The wessage 
widi be repeated at N.SECOND intervals until the condition abates 
or untidé the operator requests» via another SPO messaga» that it 
not pe displayed continualty. The software also disabtes the 
schedule when thrashing is detected so that no new jots are 
initiated. The schedude wilt be automaticalty enabled again when 
a program currently being executed terminates. 


MENOBY INITIALIZATION 


Memory is anitiaity altocated by tke software during the 
Clear/Start operation.» This single operation is composed of 
severad components. For discussion purposeser it may be thought 
of aS two separate operations. The first of the two is the 
execution of a stand-alone routines com@oniy known as tha 
Initializer and stored in the disk directory as SYSTEM/INIT. The 
initializer is brought into memory by the Clear/Start code 
contained on the cassette. The sacond operation is the execution 
of some code in the MCP» contained in Page Zero» Segment One cf 
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the MCP"s code fiie. 


At the coapletion of the initializer» memory wilt be formatted as 
shown in Figure 4.2.2 Permanently allocated areas widi be located 
at each end of memory. Linked memory will consist of four tinks 
ondy. The processor is then passed to the NCP*s code segreent for 
cormpdetion of the Clear/Start oneration. Upon completion of the 
MCP codes tinked memory wild be formatted as shown in Figure 4.3. 
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Elgure 422 Notes 


ie 3 *UTML” and "LTML* area acronyms for upper and tower 
terminating memory Links. These two tinks have a size fietd 
of zero anda type fieid which denotes a terminating memory 
dink. The upper tink has a forward pointer of @FFFFFFaQs the 
dower tink has a backward pointer of @FFFFFFa. The tinks are 
used to mark the boundaries of tinked memory for the memory 
atdocation routines.» Mewory allocated by these routines wil 
always Lie between these two Links. 


2. It is possible» during the initialization procedure» for the 
operator to specify a maximum S-memory address that is less 
than the actual maxiaun address of memory on the stystaa. 
When this is done» a proportionate atount of memory is 
reserved at the tocation shown. This memory is» iin effect» 
deleted from the system. Memory may also be deleted via 
certain keyboard instructions available to the operator. In 
the flatter case» the deteted nemory may tide at atisost any 
address in the syste. 
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Figure 423 Notes 


ie Though nothing is shown as present in figure 4.3 between the 
SOL Interpreter Segment Dictionary and the Lower Terminating 
Memory Linke this area witd typically be filled with MCP code 
segments at the comptetion of the Clear/Start operation. 


2. The purpose of the fence shown in figure &.3 was discussed 
previously. The location of the fence is retained in the MCP 
stacks. It is not necessary to reserve any memory at atid at 
the feance location. 


MEMORY REQUIREMENTS 


The memory that wilt be required to executes a given program or 
set of programs is composed of four components. There are the 
Static requirements of the operating systems the dynamic 
requirements of the operating systeme the static requirements of 
the program and the dynamic requirements of the program. 


Static requirements are composed of the data spaces necessary to 
operate the system and the prograg. Once the static requireaents 
are established» they typically do not change.» For axampier ance 
a program has ali of its files open» the memory required for the 
File information Stocks and the buffers regain fixed until the 
fides are closed. In the case of the MCP» once the syste is 
Clear/Starteds the static requirements remain fixed until the 
system is Cilear/Started again. 


Dynamic requirements are exclusively code segqsent se Assuming 
that a working set of the code segments of a program i5 
established» the dynamic requirements for that program wial then 
be the total amount of memory that is required to contain the 
code segments that are a part of the working set. The operating 
system's working set depends» of courses upon the communicate 
eperators that are issued by the program in its own working set. 


QPERATING SYSTEM STATIC REQUIREMENTS 


Those items shown in figures 4e2 and 423 coaprise the static 
memory requirements of the operating system. Each item witl now 
be discussed and a means of determining the amount of mamory 
required by the item wild be presented. The numericat vatues 
presented herein apply to the 9.39 version of the MCP only. 


MCP 
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MCP Stacks 


The stacks used by the MCP wild always reside at tocation 
zero in S-memorys. For each released version of the MCP» the 
Stacks wiitt be of a fixed sizer regardisss of the machine 
configuration. The stacks require roughty 34416 bits or 
4302 bytes. 


Page Oictionary and Segment Zero Dictionary 


These two items may never be overtaid and are gaintained in 
memory immediately above the MCP stacks. They wilt also be 
of ai fixed size for each released version of the MCP. The 
10.0 version of the MCP code is divided into thirty-four 
segment pages and Page Zero contains thirteen segments. Each 
entry consists of a system descriptors which requires 80 bits 
or 10 bytes. For the 19.0 version of the MCP» this item 
requires 3760 bits or 470 bytes of memory. 


Interpreter Dictionary 


An Interpreter Dictionary eantry requires 224 bits or 23 
bytes The number of interpreters that may be used on a 
system at any given times» and hence the nunber of entries 
allowed ain the Interpreter Dictionarys may be specified by 


the user to be any value between 3 and 31. If the user does 
not specify this numbers the Coid/Start rautine will set this 
value to six. The memory required for the Interpreter 


Dictionary may be calculated by muttiplying the nuaber of 
interpreters allowed by the size of one entry. 


Cold/Start Variables 


The variabies contained in this area are originality set by 
the Cotd/Start routine. Many af them may be changed by the 
operators The memory allocated for their storage may not he 
changed. It wilt aise be a constant vaiue for each versian 
of the operating system. For the 10.0 varsion» the memory 
required is 2256 bits or 282 bytes. 


Chip Error Table 


This area is aitocated on 31800 and 31900 series sachines 
onty. Gn ald other machines» no memory is required for this 
item. Qn the B1800 and 81900» the area is used to store the 
addresses of memory tocations. which are experiencing 
correctable memory parity errors. The size of the area in 
bits may be calculated by 49 plus (32 times the number of 
entries atiowed in the tabie). The operator may specify tha 
nugber of entries the table should contain. The defauit 
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MCP 


vaiue for the number of entries will be one entry per 15% 
bytes of S~memory on the system. 


Code in Page Zero» Segment Zero 


This code segment is normatliy referred to as "Segment Zero" 
and the size of the segment is a constant for each released 
version of tha MCP. This is the onty MCP code segment which 
does not require a mamory tinks since it is outside of linked 
me mor y « The code segment requires roughiy 53490 bits or 
6686 bytes of memory. . 


Upper and Lower Terminating Memory Links 


SDL 


MCP 


In the 1210.0 verson of the software» a metory tink requires 
187 bits of memory. These two then require 374 bits or 47 
Dytese 


Interpreter 
The sizes of the ‘SOL Interpreters presented here are for 


reference only. Accurate size figures and figures for the 
various segments of the interpreters are provided in the 


appropriate product specification. Segment Zero of tha 
S“Processor version of the SDL Interpreter requires 315656 
bytes. The same segment of the M-Processor version requires 


BO0Z4 bytes. 


Run Structure Nuciteus 


The NCP requires a Run Structure Nucleus field as does every 
other program which executes on the system. For the 9.29 
version of the softwares 2386 bits or 298 bytes are attlocated 
for this fieid. 


Micro MCP Data Space 


Currently» 1249 bits or 156 bytes are adtocated for this 
space. This requirement is a constant and is not dependert 
upon machine configuration nor system options selected» but a 
dual processor configuration wilt require two such spaces. 


GISMG Code 


GIS5M0 is not segmented. Selected portions of the GIS#O code 
are “discarded” by the Initialization routine if they are not 
required ona given system configuration with a given set cf 
system options selected. The amount of memory that wilt be 
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required to contain GIS5M0 must therefore atways be 
caiculated. 


The Main Biock of GISMO requires 5500 bytes of memory. No 
memory link is raquired. The amounts of memory shown in the 
fotiowing table shouid be added if the condition specified is 
true. 

System equipped with Memory Base 5 i04 bytes 
Processor is a B1830 436 bytes 
Processor is 81720 series . 540 bytes 
Processor is 81869 series 642 bytes 
Processor is Duat BLBXX 1070 bytes 
Reference address check option set 138 bytes 
Thrashing detection option set 142 bytes 
Pricritized memory management option set 364 bytes 
TOUT option set 100 bytes 

In the tist above» the cassette device on the precessor 


console is not considered a peripheral. Neither the cassette 
peripher ai segment nor the magnetic tape or cassette tegment 
should be added due to the console cassette. 


Tha control exchanges sagmeant shoudd be added when the systen 
is esaquipped with two or more disk or tape controis and the 
controts address the same peripnherat units. High-speed 
controits are aii disk pack controits and any controts which 
address phase encoded tape drives. Under no conditions is it 
necessary to add any GISMND code segment more than once. The 
Dual Processor segment and the 81860 segment must tooth be 
added if the system is a dual processor version. 


Firaware Yrace Space 


This area is attocatead oniy when running with trace versions 
of tha SDL Interpreter. Tt should never be ailocated in a 
customer*s machine.» It requires 14460 bits. 


Interrupt Queue 


Since interrupts occur asynchronously on the 81000 system, 
they must be queued until they can te handied by the 
aporopriate operating system routines. Gne entry in the 
interrupt queue requiras thirty"six bits. Fortystwo bits ara 
required for pointers and counters. The number of entries 
which may be queued on a given system depends upon the amount 
of memory on the system. The number of entries that wilt ba 
allocated may be datermined from the foltowing table. 


S"Memory on System Entries 


4-19 


BURRBUGHS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP Bidgoed MCP If 
SANTA BARBARA PLANT PeSe 2212 5462 CED 

Less than 64K bytes 16 

At least 64K bytes but tess than 96K bytes 20 

At least 96K bytes but less than 128K bytes 25 

128K bytes or more 390 


The smatiest amount of wemory that widl be altocated for the 
interrupt queue is then €42 + (C16 X% 36) or 618 bits. The 
largest amount is 1122 bits. 


GI380 Data Space 


+ 


The GISMO data space 38s a work area required by GISMG. It is 
a fixed size and amounts to 376 bits. 

BDEPU DATA SPATE 
This is also a work area. It is required on att duat 


processor machines and requires 350 bits. 


Looking now at figure 423» tha MCP» prior to compieting the 
Clear/Start operation» wild altocate space for those additional 


items shown on the figure. The Location of the *"Fence™ is n”dot 
important te. the discussion of the memory requirements of the 
MCP. The fence is merely a means of guaranteeing that the MCP 


wilt aiways find space for its own purposes when such space is 
needed. The system would be forced to hait if the MCP could not 
find the space required. 


Adi of the items shown in figure 4.3 reside in tinked memory. 
One memory dink (187 bits) ts required to describe each of the 
items in figure 423 


Extended Result Descriptor Area 


One extended result descriptors» I/70 descriptor and buffer is 
required for each 5N headwper-track disk controd and for each 
disk pack spindle on the system. Each descriptor and its 
associated buffer requires 256 bits. This requirew#ent 
applies to a44 disk pack drives interfaced to the #81000 
System but not to cartridge drives. The mencry required» in 
bits» may be catculated by 256 X (5N controts + disk pack 
spindles) + memory tink. 
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SOL Interpreter Segment Dictionary 


The segqrent dictionary of the SOL Interpreter is considered 


non~overtayabl e» since it contains a descriptor for segmert 
zero of the interpreter which aust be nonoverltayabte to 
execute segment zero of the MCP. The size of this arear in 


bits» may be calcutated by 664 pius €80 times the number of 
segments which comprise the interpreter> pilus the space 
required for one memory tink. The SOL Interpreter contains 6 
segments» pilus Segment Zero. 


Micro MCP Segment Dictionary 


This segment dictionary is also considered nontoverlayabie. 
Its size may be caiculated in the same manner as the size of 
the SDL Interpreter segment dictionary» 56% pius (80 tires the 
number of segments) plus space fer one memory tink. The 
Micro MCP contains 18 sagments» plus Segment Zera. Tha 
segment dictionary therefore requires 1390 bytes. 


Queue Disk Template 


The MCP reserves 500 sagments of systen disk for its on 
temporary use. The address of this reserved area ef disk» 
known as Queue Disk» is stored in the memory area known as 
the Queue Disk Template. This memory area witl also cantain 
one bit to denote the availability of each of the 359690 
segments» a 24-bit fieid which wild be used to store the 
memory address of the next Queue Disk Template if an 
additional 500 segments must de allocated and a i128-bit fieid 
known as the Communicate Splitter Mask. This latter field is 
used to determine which communicate operations may be handted 


by the Micro NCP. The size of thea iinitiai Queue Disk 
Template field is thereforer 500¢36+244123 or 688 bits. 
Additionad Queues Disk Temptate Fietds» if required» widl 


occupy 560-bit arease QGne memory tink is required on each 
Queue Disk Template allocated. 


Additional Port/Channei Tables 


The MCP and GISMO communicate in a number of ways. One such 
way is the Port/Channel tabie. One Port/Channed table is 
allocated with the SPO variables and buffer at the high end 
of iinked memory. If the system is @quinpped with multictine 
controiss an additional Port/Channed tabte will be required 
for each one. A Port/Channel table requires 768 bits of 
memory plus the space required for one memory Link. 
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GOAT Ci/O Assignment Tabie) 


Several items are grouped together in the space reserved far 
the IQOAT» The IOAT itself requires one entry of 512 bits for 
each peripheral unit connected to the system with the 
exception of the SPQ. Each disk pack spinddte is considered a 


peripheral unit. Head=perwtrack disk is note Data 
communications devices are not considered peripheral tunits 
for the purpose of calculating IBDAT size» but eacn 


singlerline control connected to the system requires ore IQAT 
entry. OQne “Pause” descriptors requiring 96 bits of temoryr 
is required for each tape controils» cassette control and 
MTC-2/MTC"4 exchange on the system. One “Lock™ descrigtor, 
requiring 168 bits of memory» is required for each tape anj 
cassette unit connected to the system. OQne [/0 descriptor of 
248 bits is required if any number of flexidisk units are 
connected to the system. Qne memory tink is required to 
describe the area containing these items. 


Port/Channel Tabier SPO Variabies and Buffer 


Information which the MCP naeds to perform its function which 
is priwarity concerned with the system SPO but aitso inctudes 
information on other aspects of the system is saintained in 
the area known as SPO Variables. This information requires 
1351 bits of memory. The Port/Channel tabie requires 768 
bits and the SPO buffer requires 560 bits» for a totai_ of 
2679 bitse Gne memory tink is required to describe the area. 


OPERATING SYSTEM DYNAMIC REQUIREMENTS 


The operating systam's dynamic memory requirements are determined 
solely by the size of the code segment which performs the 
functions requested by the user in the working set of his 
program. In determining this requirements» it is necessary to 
know what the program in question is doing. While programs could 
be and are written which hava fite open and close operations as a 
part of their working set» this is not normalty the case. The 
Vast majority of programs request only those functions which are 
microcscoded and inctuded in the Micro MCP in their working set 
code.» This statement #s not true for programs which use OMS. 


This document wilt not present the memory requirements for 
programs which use DMS. This information will probably be added 
at some point in the futures but for the present» oniy the code 
segment sizes for operations believed to be common and exctusive 
of DMS operations widi be presentad. 
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The dist below presents a brief description of the function and 
the memory requirement for each of the Micro MCP segments. 


SEGMENT.ZERQ = 2396 Bytes 


Segment Zero of the Micro NCP is adways required in menory 
when programs are executing.» 


SERTAL = 1960 Bytes 


This code segment handles reads and writes on serial files 
that are opened input or output but not in any coabination 
form» such as input*output. Alsoe some fites assigned to 
data recorders may not require this segmant. 


SEQUENTIAL = 762 3ytes 


This code segment handles reads and writes on saquential disk 
fites that are cpened inputtoutput. 


RANDOM ~ 944 Bytas 


This code segment handles reads» writes and seeks on code 
segments whese access mode is random. This code segment is 
required for ail random disk filesr even if the access mode 
is delayed random. 


COMP.WAIT - 1136 Bytes 


This code segment is required to handie compiex wait 
communicate operations. Ali data communications handters 
generated by the NOL compiler require the compiex wait coda 
to be present. 


DATARECOR - 344 Bytes 
This code segment is required to handile reads and writes an 
files which are assigned to data recorders and which are 
opened inputoutput or Input with Stacker selection 
capabilities requested. 

HI »PRIe»ANG =~ 1292 Bytes 


This code segment is required to handie alt communicate 
operations on fites which are assigned to reader“sorters. 
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QUEVE.READ - 856 Bytes 


This code segment handies read and write operations on 
queues. Piease refer ts the paragraph at the end of this 
list. 


PQM.»GQM ~- 2674 Bytes 


CPut Queue Message.Get Queue Message). This code segment 
handies reads and writes on files assigned to queues and toa 
remote files. Piease rafer to the paragraph at the end of 
thas list. 


REMOTE»WRI = 2300 Bytes 


This code segment is required to handle writes or files 
assigned to remote files. Please refer to the paragraph at 
the end of this list. 


REMOTE.REA = 2890 Bytes 


This code segment handtes reads on files assigned to remote 
files. It is aitso required to handle many NDL/MACRI 
communicates. Please rafer to the paragraph at the end of 


DC~INITIAT = 410 Bytes 
This code segment handles the OC.INEITIATE~I10 communicate 
operation. This communicate is issued by ait data 
communications handlers generated by the NOL compiier. 
MESSAGE»~CO - 208 Bytes 
This code segment is required to handte the message count 
communicate operators aiso issued by addi data communications 
handiers generated by the ADL compiler. 
VARTABLE.L - 412 Bytes 
This code segment handies read and write operations on- tape 


and disk fites which use variablectength records. It is 
required in addition to the SERIAL code segment. 
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EMULATOR.~T - 508 Bytes 


This code segment is required to handle comaunicate 
operations requested by any amulator interpreter on files 
assigned to tape. 


DELAYED.RA - 592 Bytes 


This code segment» in addition to the random code segment» is 
required to handle reads» writes and seeks on fites whose 
access type is delayed random. ECmutator disk files ere in 
this category. 


INDEXED.SE = 3620 Bytes 


This seqment is used for 1/0 operations on Indexed Seqrential 
files» first introduced in the 9.0 version of the software 
and described in the section of the document on the 1/0 
Subsystems 


RELATIVE ~ 3638 Bytes 


This segment is used for I/9 operations performed on Relative 
files» also described in the I[/0 Subsystem section. 


ipc.CODE - 3568 Bytes 


This segment is used to perform Inter=Process communications 
a part of the ANSI "74 COBOL implementation first inctuded in 
the 9.0 software. 


Add code necessary to handie queues» remote files» tha 
DCe-INITIATE.~10 communicate and the MESSAGE.COUNT communicate are 
included in the Micro-MCP. Microcoding these functions resulted 
in some substantiad performance improvements for most data 
communications applications. There are severat reasons for the 
improvemants» the most obvious being the greater efficiency of the 
code. Another factor is that a minimat amount of state 
information must be saved when communicating with the Micro NCP. 


A third factor is the elimination of the “bottleneck” problem» as 
it has come to be cadieds for data communications applications. 
This problem arises from the fact that MCPII is a flat structure 
and is capable of performing one thing at a time onty. In other 
words» once the MCP begins oerforming an open request § for 
example» it can do nothing else until it completes the open. An 
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opens of courses requires many accesses to the disk subsystem and 
the MCP must wait on the corptetion of each one. Normat-state 
programs are free to execute while the MCP is waiting on each 
access» provided they do not request an MCP service which must be 
handied by MCPII. 


Consequentiys user programs tay now use the queue subsystem and 
the other items mentioned above white MCPII is servicing another 
request for other userse In previous releasesr these same user 
programs had to wait until the MCP completed servicing the 
request it was working on at the time. Unfortunately» howevare 
all requests for functions in the queue subsystem are not handted 
by the Micro~MCP. Many of theme and possibly all of theme may 
stitd be handied by MNCPII. 


Aid memory management functions are stidii handied by SDL code in 
MCPII. Any queue request which involves temory management wit 
therefore have to be handted by MCPII. This widt most often 
occur in situations where the awailabde memory on a system i5 


Limited. Queue buffers may be written to disk by MCPLII>» and 
hence removed from memorye whenever the MCP needs space (for 
something eise. This wil cause MCPII to be invoked when a 


program attempts to read a queue entry from that buffer. 


Further» if a producer of queue entries fidis an entire buffer 
before the consumer can empty itr anew memory buffer sill ba 
requir ed. MCPIL widi be invoked to accomptish the aticcation. 
Unfortunatelys in both of these instancess the entire working set 
of Micro eMCP queue handling segments widi be brought into memory 
oniy to determine that SOL MCP segments are ready required. This 
can result in substantiadt performance degradations particularity 
on systems where avaiiabie memory is timited. | 


The situation described can be avoided» of cotirrser by insuring 
that the consumer of queue entries removes thea froma the queue at 
the same rate that the producer enters them. Since it is onty 
rarely possibie for the programmer to insura that synchronization 
exists a system option has aiso been provided in the 6.1 release 
which wiil insure that alt queue requests are handded exclusivety 
by the SDL MCP. By setting the options the user may insure that 
performance does not degrade when going to the 6.1 release» as a 
resudt of the microcoded queue imptementation» though he witt 
receive no benefit from it at all. 


Six naw segments were added to the Micro=MCP to accomodate the 
data communications facilities in the 6.1 release. The new 
segments are QUEUE.READ through MESSAGE -COUNT inctusivety. 
Typically» data communication applications which use a handier 
program generated by the NOL compiler should consider adi six 
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segments to be a part of their working set» though aniy the first 
four of the six are concerned with the queue impiemantation. The 
MESSAGE.COUNT segment is invoked by the cosmunicate operator of 
the same name and is used to determine whether or not a *sessage 
exists in the queues. The DCw~INITIATE.I0 segment is aiso invokad 
by the communicate operator of the same name and should aiways be 
considered a part of the working set for any data communications 
applications. 


PROGRAM“DEPENDENT STATIC REQUIREMENTS 


The static memory requirements of a program» that mamory which is 
required for everything excegt the program's coder may be divided 


into two classes. Three items which are required are fixed in 
size and the user has no controt over then. The user actuaity 
has tittke controi over many of the static requirements» though 


there are some items which ha may cause to vary. {tems in the 
latter category are referred to as conditional requirements. 


The fixed requirements of the Program Static Memory are composed 
of three components. These are Listed below. 
Run Structure Nucleus 
This is a table of information constructed by the ¥CP when 
the program reaches BOJ. It is a fixed size of 2386 bits. 
interpreter Segment Zero 
The size of Segment Zero» the non-overtlayabie segments» of the 
Interpreter being used must be determined and addede Space 
for one memory tink sust be included. 
Interpreter Segment Dictonary 
The number of segments in the Interpreter must be determined. 
The space required for its segment dictionary is then ten 


bytes times the number of segments plus space for one memory 
link. C10 X number of Sagments) + memory dink. 


The following are the corditional items which must be inctuded in 
the calculation of Program Dependent Static Requirements. 


Program Code Segment Oictionary 


The number of code segments which comprise the program may he 
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determined from the compiler Listing of the program. Code 


segment dictionary space in bytes is then determined by €10 X 
number of segments) # memory link. 


Data Dictionary 


The number of data segments used by the program is krown to 
the programmer and is availabie from the compiler listing. 
The space for the data dictionary in bytes is caiculated by 
C19 X number of data segments). No memory tink is required. 


BasemLimit Area @adiso known as Program Run Structure) 
This number is readity avaitable from the conpider tisting. 
It is the totai data space required by the program (between 
Base and Limit Registers). Space for one memory Link sust be 
added. , 

File Dictionary 
Theres is one entry in the fite dictionary for each file 
deciared in the program» regardiess of whether it is ever 
used or note File Dictionary space is given by (190 X number 
of files dectared). No mesory tink is required. 

File Information Block (FIB) Space 


This may be calculated in bits by: 


1048 x Number of MICR Files open pius 

796 x Number of Printer Files open plus 

605 x Number of Remote Files open plus 

796 x Number of Tape Files open plus 

1048 x Number of Disk Files open plus 

433 x Number of Quaue Fides open ptus 

1048 x Number of ait other files open at the time. 


FI8 Memory Links 


One memory tink is required for aach file that is open. 


Totai Buffer Space 


The number of and the size of the buffer areas associated 
with each fide that is open may be determined from a conmpitier 
listing. This size should be totaled and added. If the code 
file on disk has been modified» however» the size given on 
the Listing may be incorrect. True buffer size may bea 
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determined through an MCP keyboard instruction. (Refer to 


81000 Software Operational Guide.) 


I70 Descriptors 


There is one [/0 descriptors which requires 272 bits cf 
spaces for each buffer in each file that is open. 


Disk File Headers 


Disk fite headers are maintained» eaither in memory or an 
disks» for adil disk files that are open. If the fite is 
processed in arandom access mode» the header is maintained 
in memorye Htherwise» the header is stored on disk and 
brought into memory when new disk areas are ailocated. Each 
header will caquire 580 bits plus 36 bits for each area 
requested by the fite declarations regardiess of whether of 
not the area is atiocated» pilus space for one memory tink. 
This area is required only when the header is in memory. 


Header Dictionaries 


Disk file headers are addressed by the MCP through 
dictionaries. These dictionaries are segmented. One segment 
contains space for ten dictionary entries. Each dictionary 
entry is a system descriptor and requires 809 bits of memory. 
The space required for header dictionaries may be caiculated 
by (800 + memory tink) X ({disk files open MOD 10) # 1) bits. 


PROGRAM"DEPENODENT DYNAMIC REQUIREMENTS 


To datermine the working set of segments for any program one must 
know where a program spends its time or its “main tLine™ of 
procedure caddis. The corresponding segment sizes must then be 
added up for this main sequence. Segment sizes can be obtained 
from compiter listings. For RPG programse aif code segments must 
be included in the working set. For adit other programs the 
compilers produce a iist of code segments and sizes. Then the 
working set segments shoutd be Listed and totatied. Ali segment 
sizes shoutd have 20 bytes added to account for the size of an 
associated memory link. 


As previousty discussed» if any interpreter segm@ents are used by 
the programs» these must also be inctuded in the total. 
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MIMENCRY MANAGEMENT 


The function of M-memory management is to best manage the 
available control memory (Mmemory)? in a dynamically changing 
environment. There are four events which are able to affect the 
Ssystem*s demand for N-memory dy the introduction or removat of 
interpreters: 


Bod 

EQJ 
ROLL IN 
ROLLOUT 


Upon the occurrence of any of theser if the interpreter set 
changes» the new demands wilt be evaluated and M-memory 
reallocated. 


One of two aitocation schemes wild be employed: 


DISTRIGUITON 


This method distributes the available M-memory staticatly among 
the active interpreters. fhe size of each portion depends on tha 
interpreters needs» and the available amount of N-memory. The 
portion of the interpreter which is not able to be piaced in 
M~memory remains in S~mamory. As the number of active 
interpreters increases» this allocation scheme remains in effect 
untiai further dispersion of M-mamory would result in a severe 
performance degradation. when this threshold is reached» the 
second ailocation scheme is put into effect. 


CONTENTION 


This method dynamicadiy shares M-memory» in the form of n fixed 
size pages» among greater than n interpreters contending for 
these pagese when an ingerpreter succeeds in capturing a page of 
M-memorys the low-order portion of the interpreter will be copied 


into the page from S<memory. However » when the page is 
reccaptured by another interpreters since there is no rechanisn 
for transferring information from M°memory to Smeamory >» the 
information in that page wittl be tost. Hencery adit active 


interpreters must be entirely in S~memory. 


DETAILED DESCRIPTION 
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le When a new interpreter is to be brought into memory» the 
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procedure “"MeINeM.QUI™ is catied.» This may be caiiled either 
from 80J» E03» ROLLIN» or ROLL.QUT. The last entry in the 
interpreter dictionary is first stored in "DIC.LAST.LOC*. 
Then the interpreter dictionary is searched for entries 
whose usercount is equal to zero (thus no tonger in use). 
These antries are deleted by cailing "M.~CLEAROQUI™. 


The previous aliocation method is then stored. lf there is 
no MeaMEMORY on the system (B1710 series)» then the procedure 
"NOM" is calded. NOQ..M examines in turn» each entry in the 
interpreter dictionary to ascertain if it is in S»MENORY or 
note and if not» the procedure *0.T0.5" is cadied tea bring 
in the interpreter from disk. The presence oit is then set 
Calthough the system has no MeMENORY)» and 2 pseudo N.~MEMORY 
address is calculated and stored in "1D.M.ADDR". NO. then 
exits to Me~IN»M.OUT and thence to the procedure which cadted 
M.IN.MeOUT. 


Assuming that M.MEMORY does existe the totai minimum numder 
of M.MEMORY pages required for ali interpreters is added to 
that required for CSM» then this total number of pages is 
compared to the total number of pages of Me-MEMORY available 
on the system. 


If the totad number of pages required is greater than those 
availabies»s then the contention method is invoked» otherwise 
the distribution method is invoked. The contention method 
wid be discussed first. For the distribution sethod» 
proceed to step 6. 


The contention method calis the procedure “CNTN.~SETUP™. 
CNINSETUP first checks to see if the pages remaining after 
CSM ais adktoacated is tess than 2» and if soe then att the 
interpreters will be contending for the remaining cage», 
including SDL» and the procedure contention is caifted 
Cproceed to step 3). If the number of remaining pages after 
attlocating CSM is not Less than 2» then this number of pages 
is stored in "“MsaNUMBER.PAGES". The SOL interpreter is 
assigned a pager plus any fraction of a page which may be 
left over. This may occur if CSM does not occupy exactly a 
full page» normadly 1024 words. Next» the number of active 
interpreters is counted and this number comoared against 
M.NUMBER. PAGES. If M»~NUMBER.-~PAGES is greater than or equat 
to the number of active interpretersr then the distribution 
method is catded (proceed to step 6). (This could be caused 
by an interpreter with a very targe minimus requirement.) 


The procedure contention first ascertains if the SCL 
interpreter is partialiy resident in S MEMORY» and either 
MeNUMBER.~PAGES is equadi to il» or the portion of the SOL 
interpreter in MeMEMORY is greater than the size atiocated 
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for SOL. If so» then the procedure “HIL.~T0.5" is cattedr 
eise proceed to step 4. HIL.~TO.S saves the current 5.MEMORY 
address of the SOL interpretare and stores the disk address 
of the SDL interpreter in the interpreter dictionary entry 
for SDL. The procedure "0.7005" is then called to bring in 
the interpreter from disk. DeT025 dooks for memory for the 
interpreters makes the found address mod. 16% reads the 
interpreter into mamory and marks the interpreter dictionary 
entry present. If sufficient memory space was not found» 
then the previous (partial) SDL interpreter is restored in 
S»MEMORY» and ald procedures exited» returning adi zeros ta 
the procedure which calied Me»IN.»aM.0DUT. Otherwise» the new 
copy (complete) is marked not present in MsMEMORY and the 
memory space of the otd partial copy marked availabte. 
HIL»T0.3 now exitses returning to the contention procedure 
(proceed to step 5). 


If neither “"M.NUMBER.~PAGES” is equal to 1 nor the portion of 
the SDL interpreter in M»MEMORY is greater than that 
aiilocated for SOL» and if the portion of the SOL interpreter 
in M.MEMORY is tess than that allowned> then the procedure 
"iK.QUT.MOR™ 4s catlted to move more of the SOL interpreter 
from SeMEMDRY to M»eMEMDRY. 


The procedure "“M.eCLEARGUT™ is then cadied to ciear out of 
the interpreter dictionary ada partiattly resident 
interpreters» with the exception of SDL. Each entry in the 
interpreter dictionary is then in turn examined» and passed 
through the procedure "CNIN-LOADR® untati ali entries are 
exahinede at which time contention is exited to M~IN.M.~OUT 
(proceed to step 10). 


The function of the procedure “"CNITN.LOADR™ is to toad 
interpreters either from disk to SeMEMORY» and/or fron 
S»MEMORY to MeMEMORY. It first examines the interpreter 
dictionary entry to determine whether the interpreter is on 
disk or in 5.MEMORY. If it is not in 5.#MENORY>» then the 
procedure "0.70.8" is catied to bring the interpreter in 
from disk. lf sufficient memory space is not founds then 
D.T0.5S exits through ali procedures» returning ail zeros to 
the procedure which cadled MeIN.N.AQUT. "IO.Me-ADDK" and 
"ID»TOPMN”™ are calculated. Each interpreter is set up for 
one page of memory. Tf there is available MseMEMORY teft» 
then the page is overlayed from S.MEMORY to *€*.MEMORY 
(proceed to step 10). 


If the totadt number of pages required $5 not greater than 
those aveitlabier then the distribution method is invoked» 
and the procedure "REDISTRIBUTION™ calted. The precedure 
redistribution caicutates whether the amount of available 
Me»MEMORY is exactly of a size required to house the #siniaus 
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requirements of ali interpreters and CSM. If so» then the 


7. 


procedure "MeGRINDER* is catied passing a vatue of i. 
(Proceed to step 7). 


Otherwise» the total amount of memory required te house the 
maxinum requirements of att interpreters and CSN is 
calcudated and compared against the total amount of N.MEMORY 
available» and if iess than or equat to the amount of 
MeMEMORY availables then the procedure MsGRINDER is catied» 
passing a value (fieid WHICH ) of zero (proceed to step 7). 


If neither of the above canditions is met Cthat is» neither 
the minimum nor the maximum of ail interpreters widl fit in 
MeMEMORY) then the procedure "DISTRIBUTE" is cailed» passing 
a vadue (field HUH) of zero. The procedure distribute 
stores the maximum availabte M.MEMORY» anount required for 
CSM» then if HUH = 0» it initially assigns each interpreter 
its minimum required space» increments each one in turn by 
one page» untit ali available N.MEMODRY is adtocated. If HUH 
= js each interpreter*s minimum is assumed to be zero» then 
incremented by one paga untidt ati available M.MENORY is 
aditocated. The procedure 4.GRINDER is then called» passing 
a vatue (fietd WHICH) of 2. 


The main function of 4eGRINDER is to reatliocate M.~MEMNORY one 
of three different ways» depending on the vatues of "WHICH™. 
M.GRINDER examines each interpreter dictionary entry in 
tur ne After having examined all interpreters» if there is 
stild some M.MEMORY remaininge then proceed to step 9» 


otherwise proceed to step 10. 


If the entry being examined is not in MeMENGRY» or the page 
being examined is not the current MeMEMORY pager then 
proceed ta step 9. Btherwisesr if the size of this page in 
MeMEMORY is not the size it should be» proceed to step 6. 


If this M»MEMORY page is the correct size? and if the 
interpreter is sither partially resident in S-MEMORY or iif 
the total tength of the interpreter is less than or equat to 
the amount of this interpreter currently in MeNEMORY Cie.» 
the interpreter is entirety in .MEMNORY)> and this 
interpreter is not in S.MEMORY» then proceed to step Ye 


Otherwise (that is» the interpreter is entirely resident in 
SaMENORY>» $0 the portion of S.~MEMORY which was copied to 
MeMENQRY must be returned)» the interoreter is marked as 
partiaildy resident in S.MEMORY. Tf the total tength of the 
interpreter is fess than or equal to the amount of the 
interpreter currently in M..MEMORY» then the procedure 
"ALL.~INM" as called to return the entire S.MENGRY space for 
this interpreter. Otherwise» the procedure “LKeOUT.FEM" is 
called to return the SsMEMORY space corresponding te that 
portion of the interpreter which has been copied into 
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M.MENORY. 

Be If the amount of the interpreter in MeNEMORY is tess than 


Fe 


id. 


the amount atliocated in M.MEMORY for this tnterpreters» then 
the procedure “LK.OUT.«NOR* is calded to copy more of the 
interpreter from SeMEMORY to M.MEMORY. 


If this point is reacheds then the appropriate interpreter 
must be brought in from disk. 


The procedure "M.CLEARQUTI* is catted to clear out ait 
partial interpreters from the interoreter dictionary Cwith 
the exception of the SOL interpreter and already fitted 
interpreters). 


If the current entry in the interpreter dictionary is SDL» 
then the procedure HIL.~7T0.5 is catied Crafer to step 3 for 
the functions of HIL.~T0.5). if sufficient memory space is 
not found in HIL.~T0.5» than exit through ali procedures 
passing a vatue of ail zeros to the procedure which catted 
MeINNwOUT. Next» each entry in the interpreter dictionary 
is examined in turne and if present in S»MEMORY but not in 
MeMENORY» than the procedure "5.70.4" is called to overtiay 
the appropriate page from SeMEMORY to N»aMEMBRY» and to 
return either the entire SsMEMORY space occupied by the 
interpreter or alse to return only the portion overtaid. 
Each entry in the interpreter dictionary is once again 
examined in turns and if the presence bit is set» proceed to 
step 10. 


If the presence bit is not set» then the procedure 0.176.585 is 
caided to bring in the interpreter from disk to memory 
{refer to step 3 for a description of 0.10.5). If 
sufficient memory is not found in §.70.5»5 then att 
procedures are exited» passing a value of ail zeros to the 
procedure which called N«IN.M.OUT. 


The procedure S.T0.” is then catted (see description above). 


At this points the atlocation method Ceither distribution or 
contention) has been decided and executed» and control 
passed back to NeIN.M»OUT. 


If the new addocation method chosen was successful» and if 
the new allocation method 118s the same as the old ones 
proceed to step ii. If the new method is distribution 
C(therefores the ald was contention)» then the procedure 
RELEASE.AeSEG ais cahied to mark the MCP segment REIN.STATE 
availabdie (reset save bit in the memory tink). If the new 
method is contention» then the procedure SAVE.A.SEG is 
called to mark the MCP segment REIN.STATE saved (set save 
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bit in the memory Link). 


11. If the value passes to MeGRINDER CWHICH) was 0 or i. Then 
return from Me»GRINDER throwgh redistributions to M~IN.~M.0UT. 
If the value passed to MeGRINDER CWHICH) was 22 then return 
from M.GRINDER through DISTRIBUTE to REDISTRIBUTION» to 
MoIN.M.OUT and thance to the procedure which caited 
MeINeM»OUT. | 
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PROCESS CPROGRAM) MANAGEMENT 


Viewing the MCP as a manager of processes eaphasizes its rote in 
the management of job execution. That part of the MCP concerned 
with such management may be termed the "process controitiler*. 
While the process controdder is not a distinct module in the MCP, 
it is a convenient term to describe ail those distinct functions 
whiche taken togethers» form a conceptual package. Certain of 
these functions» nameiy "ROLLIN"™» “ROLLOUT">» "CAUSE" >» "HANG 
PROGRAN* >» are best understood within this context and sidi be 
discussed in depth in this section. 


The actuait execution of programs» the attlocation of processor 
time to processes which are ready to execute and ares therefore 
in the Ready Queue» is accomplished by micro code contained in 
GISM0 known as the "Micro Schaduler™. The Micro Scheduler is a 
part of the process controlter. The Micro Scheduter is 
responsible for the atlocation of aii processor time on ail 
processors which may be attached to the system. 


The process controiter is driven by the occurrence of certain 
software events» calded "soft events*» hich can be idertified 
and anticipated by the MCP. When a process submits a request to 
the MCP» the process may or may not be required to waite If a 
wait is necessary» the NCP is able to anticipate the event upon 
which that process must wait. Thus the MCP can tabet the job as 
waiting for some “soft event™» suspend the joo by piacing it in 
the “wait queue"» and continue to execute its other duties. When 
the soft event “"happens"» the Micro MCP can search the wait queue 
to discover the process marked waiting for the happening of that 
eyen tea 


The "HANG PROGRAM” functions which places programs in the wait 
queues and the "CAUSE" function» which takes programs from the 
wait queues are cruciad. Both functions must be cognizant of the 
same soft eventse "HANG PROGRAN™ is responsible for creating a 
unique bit string which wiit represent the saft event for a 
process. On the other end "CAUSE" must have the proper soft 
event generated for itr so that the waiting process can te 
located. 


~ 


The main asset of this mathod of process manipulation is to free 
the MCP from waiting for the corpletion of [70 operations. It is 
able to initiate a requested operation and to independently match 
a soft event with its corresponding process at a future tire when 
the operation has been completed. 


_ 
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The process controdier receives inputs from two sources: an “I/0 
DEVICE* or a "CONTROL DEVICE”. Both may affect processes in the 
system. User damands upon the system are submitted through a 
controd davice which may accept only controt language statements. 
On the 81000» the supervisory printer (SPO) may oniy be used as a 
controt device. The card reader may be dynamicaily assigned as a 
controt device or an I/0 device. Alf other peripheral devices 
may be used as I[/0 devices only. In additione a4 program #ay act 
as a controt device by sending a communicate to the MCP which 
contains a control language statement. See "PROGRAM 
COMMUNICATES". 


Controt tanguage stateamentse of direct interest to the process 
controdier» may be divided into three categories: 


(1) Statements which generate a soft event Ceeger adtow a 
suspended process become actives direct a process to a 
peripheral device) 


(2) Statements which cause job suspension 


(3) Statements which request job execution and provide ati the 
appropriate parameters 


If the control danguage statement requestad that a job be 
executed» the "Control Language Processor” directs that the joo 
be scheduled. Briefiys» the scheduling function involves placing 
it in the “schedule queue” but allocating no machine resources. 
In the MCP outer toop» the schedule queue is periodicaily 
checked» and the first job in the queue is initiatized. 


"Program Initialization* invodves allocating the gxachine 
resources and setting up the structures necessary for program 
execution. Onee the job has been initialized» iat is piaced in 
the "READY QUEUE" to await actual execution. 


Once a program has been initialized» it wiif move in and out of 
six possible states during the course of its life in the system: 


READY QUEUE 

COMMUNICATE QUEUE 

WALT QUEUE 

NOT QUEVEDs EXECUTING 

NOT QUEVED» COMMUNICATE BEING ANALYZED 
M COMMUNICATE QUEVE 
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The ready queue contains jobs which are ready to rune The 


communicate queue contains jobs which have requested some MCP 
function. The wait queue contains jobs which are waiting for the 
happening of a “soft event". 


The queuing mechanism is managed as foltows. Ali run structures 
are linked in memory by priority. A field in the run structure 
nucteus, PRS eQeT DENT» specifies the current state of the 
process. The first member of a queue can thus be found by 
searching the tinked tist of run structures untift the proper 
value in RS»@.IDENT is found. 


A job waiting in the ready queue represents a demand (for 
processor time upon the system. This queue is interragated by 
the Micro Scheduler. If a job is founds the reinstate function, 
which is performed by the Micro Scheduder in GISMO>» jis catted in 
preparation for turning the processor over to that job. Sriefiy» 
the reinstate function performs certain housekeeping duties and 
Causes a processor to begin execution of that job. 


The program wild execute until one of three things happen: 


C1) The program's interpreter discovers an interrupt which 
requires the NMCP*s attention.» 


(2) The program needs some MCP service performed before it can 
continue 


(3) The master processor instructs the stave to idle. 


in any case a communicate message is buitt in a fieid catied 
RS -COMMUNICATE.MSG»PTR an the program*’s Run Structure Nucleus and 
control is passed back to the Micro Scheduler. 


The contents of RS»«COMMUNICATE.NSGePTR» anadyzed by the 
“communicate handler” in the Micro Scheduler» specifies what 
action is to be taken upon the program. in the case of (1) 
above» the message wild simply contain a request to be put back 
in the ready queue. (The Micro Scheduler then returns to its 
outer toop where it independently discovers the INTERRUPT.) 


A request for service (2) may or may not require that the program 
wait for the happening of some soft event. If the request can 
immediately be serviced» the Micro Scheduler does so and piaces 
the job back in the ready queue. If the program must waite 
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however» the “HANG PROGRAN” function is catled. 


"HANG PROGRAM® puts the job in the wait queue and labets it as 
waiting on the appropriate soft avent. Denanding on the reason 
for the wait» the program may or may not be "roiled out*. The 
"ROLLOUT™ function wilt copy ali but a centrat core of the 


program*s Run Structure Nucieus to disk. For a detaited 
discussion of these functions» see their respective sections 
belowe 


The program witl remain in the wait queue until the event upon 
which it was waiting has bean “caused. Thea seft event upon 
which a job must wait may come from three basic sources? 


€1) 70 interrupts 
C2) Control tanguage statements 
C3) MCP 


1/0 interrupts are "hard events” which must be transformed into 
soft events before they may be associated with a process. A hard 
event is any asynchronous occurrence in the hardware of which the 
software must be cognizant. The occurence of such a hard event 
is usuadty manifested by a fiag in the processor. The function 
of "1/0 COMPLETE" is to transform those hard events of interest 
to a process into its corresponding soft event. 


Some control language statements widit cause the control tanguage 
processor to generate soft events. Such statements signify the 
happening of some event a process might be waiting for Ce.sge» 
MAX" » "EL" > *UL"» "GO"» and "DK"). 


Other soft events are generated internaditly by the MCF. For 
examplar processes waiting on a no~memory condition or a parent 
program waiting for the termination of a nested program must be 
notified when they are abte to resume processing. The MCP 
generates such soft events. 


At the point when the soft event has been generated (fro 
whatever source)» one can say that the "event has happened”. 
This soft event is used by the Micro Scheduder function to tocate 
the corresponding process in the wait queue. 
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If the process is in memory Chad not been rotted out)» the Micro 
scheduler analyzes the reason that the process had been waiting 
to determine whether or not the last communicate was corspleted. 
If it wase the job is put in the ready queue te anait 
reinstaterent. If the communicate was not completed» the job is 
put in the communicate queue to wait for the reinitiation of the 
communicate by the communicate handier. 


If the process was not in memory and memory is available» then 
the "ROLLIN" function is cadied. Its duty is to retestablish the 
run structure that had been “"roflied out” to disk. The reason for 


waiting is then anadyzed in the same manner described above. if 
there was no memory available for rolticin»s then the job is put 
back in the wait queue to wait for menory. The wait reason wilt 


be updated to refdect this status change and to specify into 
which queue the job would have gone had memory been availiable. 
When memory becomes avaitabie» the job wilt be put directiy into 
the specified queue. 


The process widd continue to be manipudated in this fashion untit 
it has completed execution. At that tige it wifi request the 
end@-of-job function from the MCP and terminate. 
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DEMAND MANAGEMENT 
MCP QUIER LOOP 


The MCP can be viewed as a program whose sote duty is to respond 
to demands made upon it by the system. This seemingly innocuous 
Statement is valid even though the MCP is a vastly cospiex 
program. The complexity arises» however» by virtue of the 
diversity of demands to which the MCP is able to respond. 


There are five basic categories of demands to which the McPe 
initiadtly responds. These categories are recognized at the 
outermost or most giobal level of the MCP» which iteratively 
searches for each. Onee a demand is found» it is anatyzed at 
increasing teveis of detail and resolved according to its 
specific request. Controt is then returned to the outer loco 
which continues to search for damands. 


The five types of demands recognized by the MCP*s outer tocp are 
described Delow. 


TiME& LNIESRUPT 


The first type of demand recognized by the MCP is called a timer 
interrupt. There are two fields in the MCP*s giobal data space: 
A software maintained system clock and a clock mask. Every tenth 
of a second an interrupt is caused by the hardware. GISMO 
detects this iaterrupt and bumps the system ctock. Every time 
the MCP begins its loop searching for demandsr it checks tc see 
if the vatue of the system clock has exceeded the value of the 
clock mask. If it Nase the MCP caddis the "N.~SECOND™ routine to 
perform its housekeeping duties and resets the clock mask to some 
value greater than the system clock. See "N»SECOND routine™. 


i720 INTERRUPTS 


An 1/0 irterrupt is a soft mechanism by which GISMO notifies the 
MCP that an I[/0 operation is completa. GISMG witt onty do sa 
when the MCP requests that it be notified or when an exception 
condition has occurred on the i/0 operation. This should not be 
confused with a “service requast™ type af interrupt. This 
service request is a hard level in the processor and is used to 
notify the software that a hardware I/0 controt is in need of 
service. 
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The MCP wild request notification of the occurrence of 1/0 
competion only when there is a need for it to know. The cP 
does not request the return of 1/0 complete interrupts on user 
1/0 operations untess the program which caused the operation to 
be initiated is waiting an the I/0 operation. This is discussed 
further in the sections of the specification covering READ and 
WRITE. 


When an I/0 operation is completed» GISMQ stores the resutt 
descriptor associated with the operation in its proper tccation 
in memory. The field is known as the “result descriptor fietd" 
and 3s a part of the actuad [/0 descriptor. There is an area 
allocated in memory known as the interrupt stacks which is 
actually a queue of I/0 complete interruptse GISMO» after 
storing the result descriptors if the interrupt request bit in 
the descriptor was one Stores the address of the resuit 
descriptor in the interrupt stack and “causes™ the MCP» if it is 
waiting. In its outer toop»r the MCP requests that GISM0 detiver 
the address on the top of the interrupt stack. It analyzes the 
descriptor at that address and takes the appropriate actions. fhe 
MCP continues to request addresses from GISMOG in this fashion 
untii the stack has been exhausted. 


Upon receiving a descriptor’s address from GISMOs» the MCP invokes 
aroutine calted “*10.COMPLETE" to begin the analysis. Depending 
on the vadue found in a fistd of the resudit descriptor, 
IO0.COMPLETE invokes one of the following MCP facilities» each of 
which is discussed in depths on the following pages. 


CAUSE MECHANISM (SEE “PROCESS MANAGEMENT™) 
CONTROL LANGUAGE PROCESSOR 

IQGAT MAINTENANCE 

I70 ERROR HANDLER 

SPQ MAINTENANTE 


JOB SCHEQULING AND INITIALIZATION 


After exhausting the interrupt stack» and if an MCP gicbatr 
"CHANGE. BIT*» is true» the MCP checks the “"“schedude queue” to 
determine if any jobs have been scheduted for execution. 
CHANGE.-BiT widi be false whenever a previous atteapt at program 
initialization failed because of insufficient memorys and nothing 
has intervened to create a possibility of success at this 
attempt. The program initialization routine sets CHANGE.8IT to 
wero (false) whanever an initialization faits. It is set to one 
{true) whenever a block of memory is freed by job termination or 
“rollout"™s»s whenever anew fob is placed at the top of the active 
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schedules» or whenever explicitly set by the "PS" control Language 
Statement. The MCP is thus abie to maximize its own resources by 
bypassing a futile attezpt at job initialization. 


The schedude queue contains an active and a waiting schedule. 
Both are tlinked dists on disk which contain those jobs awaiting 
execution but for which no memory resources fave yet heen 
aldocated. The control language processor identifies a request 
for a job to be executed. It builds a log entry {see “LOGGING 
INFORMATION") for that job and @tinks it By priority and time of 


request to other jobs waiting to be initia@ized. See "CONTROL 
LANGUAGE PROCESSOR™ for exact specifications. The active 
schedule Lists those jobs that are ready to run. The waiting 


schedule contains those jobs whose initialization gust await the 
occurrence of some event Cise@e» the termination of another job or 
operator control message). When the event happens» the job is 
transferred from the waiting schedule to the active schedule» 
where the NCP wild find it. 


The MCP selects the first job in the active schedule for 
initialization. once the job has been de queueds control is 
passed to the “program initializer" which adiecates the machine 
resources and sets up the structures necessary for the program’s 
execution. 


COMMUNICATES 

A program may request certain services from the MCP. These 
requests represent another class of demands to which the MCP must 
respond. The "communicate queue" contains jobs which have 


submitted such a request. 


The queuing mechanism is managed as follows. Each run structure 
Ul ntains two fieids: "RS5.~COMMUNICATE.MSG»PTR” which is a 

standard message afea and “R5eQeTDENT" + which specifies in which 

queues if anys the program ise The value of RS.2.1T0ENT may be: 


0 = READY QUEUE 
1 = COMMUNICATE QUEUE 
11 = WAIT QUEUE 
“2 = NOT QUEVED (€i.@e» running) 
iG = MMCP COMMUNICATE QUEUE 
3 = EXTERMINATE QUEUE 
Ali run structures are linked together by priority. Thus the 


members of a given queue may be discovered sy searching the 
linked tist of run structures and checking RS.~G.IDENT. 
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The first job in the communicate queue is serviced according to 
the contents of RS~COMMUNICATE.MSG.PTR. The message is initially 
analyzed by the communicate message handfing routine which calias 
the proper subroutine to further analyze the message and take the 
appropriate action. The proper subroutine is determined by the 
first two bits of this message area called "RS.LTYPE*. The 
values and corresponding meanings of this fietd are as fotions: 


INTERPRETER GENERATED COMMUNICATES 


00 = 

O01 = PROGRAM GENERATED COMMUNICATES 
10 = UNGEFINED 

1i = FILE CLEANUP COMMUNICATE 


Interpreter generated communicates contain requests from the 
program's interpreter for services which are unrelated to the 
program's code. These include requests for missing segment se 
trace and run time error messagesr etc. 


Program generated communicates are requests for code related 
services such as I/30 operations. These are specified under 
"PROGRAM COMMUNICATES”. 


The file cleanup conmunicate is an MCP generated communicate used 
in conjunction with program end-ofjob. 


PROGRAM REINSTarTe 


To be specified. 


PROGRAM COMMUNICATES 


Adi object programs comsunicate with the MCP by means of a 
Communicate S~operator. The operator serves to transfer contrat 
from the user*s interprater to the MCPs. Though many 
communicates are now handied by micro-code in the MicrowNCP» the 
means of communication has not changed. The compiler generates 
code which establishes an area in the program*’s run structure. 
This area generality conforms to a standard format which is 
recognizabie by the NCP. The fields in this area are defined. 
arbitrarily» however. Onty the first twetve bits of the fietd 
must conform to the format prasented below. 
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COMNUNICATE FORMAT 


ee a a 


VERB 9- if 
OBJECT iz 35 
ADVERS 36 = &F 
CT.i 48 = 71 
CT.2 fe" 95 
CT.3 96 = 119 
CT.4 120 = 143 
CT.5 144 - 167 
CT.6 168 = 191 
Ci.7f 192 = 215 
CT.8 216 =~ 239 
CT.9 2490 - 263 
CT.10 264 = 297 
Ci.11 298 =~ 32% 
CT.12 322 ~ 345 
CT.i3 345 ~ 369 
CT.i4% 379 =~ 393 
CT.215 394 =~ 417 


en a ETE OE SEP EO eee 


Note? Adi communicates return a vaiue of 2000000000000 or 
29000180000002 in the RS.~REINSTATE.MSG.PTR unless 
otherwiss gpecified. 


Adi interpreters» when executing the Communicate S*operator>» 
store a pointer toa the reserved» formatted memory area in the 
field ca@lited RS»~COMMUNICATE.MSG»PTR of the RSe«NUCLEUS cf the 
program being executed. fhis fortyceight bit field specifies not 
ondty the relative address of the communicate areas but also the 
size of the area in bits. For further information on this aspect 
of the operations refer to tha programmatic description of the 
Run Structure Nucleus. 


if the MCP needs to convey information back to the object progran 
after executing the requested communicates it does so by setting 
the fieitd cadi@ed RS»REINSTATE.NSG.»PTR to a selected vaiue.e If no 
information is to be conveyed» this field is set to either 
9000000000029 or 30000280000092 before reinstating the program. 
Other vaiues» and their associated geanings depend upon the type 
of communicate being executed» and are described for each 
communicate in the sections which follow. 


7-6 
BURROUGHS CORPORATION : oe COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP 31000 mCP if 
SANTA BARBARA PLANT P.S5e 2212 5462 CE) 
CT.¥ERG 00 


ILLEGAL COMNUNICATE 


READ CHICRO NCP) 


CT.VERB 01 
CT~OBJECT FILE «NUMBER 
CT~ADVERS Bi 


Q REPORT & RETURN TO USER ON EOF 
i REPORT & RETURN TO USER ON PARITY 
2 REPORT & RETURN TO USER ON INCOMPLETE I/0 
3 LENGTH ADDRESS PAIR 2S PRESENT FOR RESULT MASK FIELD 
7 STACKERS=-STACKER # IS IN CT.3 
8-11 = 
CT. LOGICAL RECORD BIT LENGTH 
CT.2 LOGICAL RECORD BASE RELATIVE BIT ADDRESS 
CT.3 RANDOM FILE ACTUAL BINARY DISK KEY 
(RECORD NUMBER INSERTED BY MCP FOR SERIAL FILES) 
OR 
LENGTH OF KEY FOR REMOTE FILES 
CT.4 ADDRESS OF KEY FOR REMOTE FILES ONLY 
cT.5 LENGTH IN BITS OF RESULT MASK 
CT.6 BASE RELATIVE ADDRESS OF RESULT MASK FIELD 
REINSTATEsMSGSPTR VALUES 
Q GOOD READ 
1 END OF FILE 
2 170 ERROR 
3 INCOMPLETE 1/0 
4 IMPOSSIBLE SEARCH CRPG SEARCH OP) 


A READ communicate on the B1000 System serves to detiver a 
dogicalt record to the user program. It does this by moving the 
record from the I/0 buffer area in memory» where it was 
previousdy stored by the CSM» to the users Run Structure 
(Base/Limit) area» In almost ali cases» the READ» WRITE and SEEK 
communicates are performed by the Micro-MCP. This has been true 
Since the 5.21 release of the software. 


The information passed in the communicate area must inciude a 
unique file number. This number is assigned by the compiters and 
is passed to the MCP in CT.GBJECT. The sawe statement is true 
for a&d communicates which deat with an [70 operations such as 
WRITE» SEEK» OPEN» CLOSE» POSTTION and so forth. 


The communicate information must aiso contain the baserretative 
address of the memory area where the record is to be stored and 
the length» in bits» of this area. These items are passed in 
ci .2 and CY.i» respectively. 


the 
for 
not 
For 


user program to wait until a requested I/9 compieteas. If» 
examole» the program is reading cards and the card reader is 


ready» it may be a tong tiwe until the operation conpletes. 


such programs» the third bit in CT.ADVERS is used. Setting 
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this bit causes the MCP to return control to the user programs 
regardiess of whether a record was delivered or not. If no 
record was delivered» the program is informed of the situation by 
setting proper values in RS»REINSTATE»MSG.»PTR. This is discussed 
in more detail later in this section. 


Remote files may consist of more than one data communications 
terminate. In such a case» it is necessary for the cbject progras 
to specify the identification of the terminal it wishes to read 
from. This is accompdished by setting CT.~3 and CT.4 to the 
proper vatues. 


in ait three of the cases descrided previously» where bits ones 
two or three are set in CT.~ADVERS» it is necessary for the MCP to 
inform the user program of the existing condition. This is 
accompdlished by setting a field in the RS.~NUCLEUS to a specific 
vatue prior to reinstating the program. The field is defined as 
RE~REINSTATE.MSG.PTR and is accessed by the user’s interpreter as 
soon as it is reinstated» after doing a communicate. If a vatid 
record was delivered to the user» the message field is set to a 
value of zeroe It wiil be set to one» tuo or three if the 
respective bits are an in CI.ABD¥VERS and the condition assigned to 
these bits exists. 


If aouser program READ communicate encounters an end-of-filte 
condition and bit ore in CT.ADVERB is not set» the orogram will 
be discontinued by the MCP. If a user [/0 operation resuits in 
an irrecoverabie error and bit two its not sat in the READ 
communicate which requests the records the program witt be 
discontinued by the MCP. If a user program requests the data 
from an I/7Q operation which is not yet complete and bit three of 
the adverb is not set» the program is merely forced to wait for 
the I/70 completion.’ . 


For files which are assigned to Data Recorders and other selected 
card Input/Output devices» the user may specify that the card 
which was read is to be routed to a certain physicai stacker on 
the device. This is accomplished by setting the specified bit in 
CT~ADVERS to one and by setting CT.3 to the binary number which 
designates the physicatl stacker. In this case» there is never a 
need for more than one buffer area to be assigned to the filer 
and thea MCP OPEN routine wild prevent this from happenings Card 
1/0 operations itn this case are not “buffered* and card 
throughput wit decrease accordingly. 


For random disk files» a READ communicate may not result in an 
1/0 operation being initiated. If the user who does the READ 5 
the sole user of the file and if the block which contains the 
requested record is atiready in samory in one of the user's buffer 
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areass the requested record witi be simply moved to his work 
ar @ae This action is not performed if there is more than one 
user of the file. 
WRITE MICRO NCP? 
CT.¥ERB 02 
CT.OBJECT FILE NUMBER 
CT.ADVERS BIT 
0 REPORT & RETURN TO USER GN EOF 
1 REPORT & RETURN TO USER ON PARITY 
2 REPORT & RETURN TG USER ON INCOMPLETE 1/0 
3 LENGTH ADDRESS PAIR IS PRESENT FOR RESULT MASK FIELD 
4-5 ~ 
6 QUEUE FILESs WRITE TO FRONT OF 
QUEUE ("STACK"). 
rd STACKERS-“STACKER # I5 IN CT.3 
Beil PRINTER SPACING €4 BIT VALUE) 
0 NG PAPER ADVANCE 
1 SKIP TO CHANNEL 1 AFTER PRINTING 
2 SKIP TO CHANNEL 2 AFTER PRINTING 
3 SKIP TO CHANNEL 3 AFTER PRINTING 
& SNIP TO CHANNEL 4 AFTER PRINTING 
S SKIP TO CHANNEL 5 AFTER PRINTING 
6 SKIP TO CHANNEL 6 AFTER PRINTING 
Y SKIP 10 CHANNEL YF AFTER PRINTING 
8 SKIP TO CHANNEL 8&8 AFTER PRINTING 
9 SKIP TO CHANNEL 9 AFTER PRINTING 
A SKIP TO CHANNEL 10 AFTER PRINTING 
8B SKIP TO CHANNEL 41 AFTER PRINTING 
C SKIP TO CHANNEL 12 AFTER PRINTING 
D SKIP 70 TOP OF FORM €15090 LPM PRINTER ONLY) 
— SINGLE SPACE AFTER PRINTING 
F DOUBLE SPACE AFTER PRINTING 
CT.1 LOGICAL RECORD BIT LENGTH 
CT a2 LOGICAL RECORD BASE RELATIVE BIT ADDRESS 
CT.3 RANDOM FILE ACTUAL BINARY DISK KEY 


A 


(RECORD NUMBER INSERTED BY MCP FOR serBar FILES) 
OR 
LENGTH OF KEY FOAM REMOTE FILES 


CT.4 ADDRESS OF KEY FOR REMOTE FILES ONLY 
CT.5 LENGTH IN BITS OF RESULT MASK 
CT.6 BASE RELATIVE ADORESS GF RESULT MASK FIELD 


REINSTATE»MSGePTR VALUES 


WRITE 
Simitar to READ. 


0 GOOD WRITE 

1 END OF FILE 

vd I/0 ERROR 

3 INCOMPLETE i/0 


Bi000 system operates in a manner 
fogical record 


on the 
The user program constructs a 


communicate 
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somewhere within its Run Structure and communicates with the CP. 
The MCP will then move the data from the work area» the address 
and iaength of which are described by CT.2 and CTel respactively» 
to the next avattiabie I/0 buffer area. The program witi ba 
aliowed to continue as soon as the movement of the data occurs? 
it is not forced to wait for completion cof the actuat I[/0 
operation. 


As in the case of the READ communicate» either blank-fidi or 
truncation of the record will scecure depending upon the sizes of 
the work area and the fite*s togicadl record. The buffer wild be 
released» which means that the corresponding 1/0 operation wiil 
be initiated» as soon as the buffer area has peen fiiled to 
capacity. A program is forced to wait for [70 comptetion if the 
MCP cannot find an avaitabie buffer to which it can move the 
record. A buffer is unavailable if the previous I/0 operatian»s 
which may have been initiated some time ago» is not yet complete. 


End~of-file is not raported to a user on an output File except in 
the cases of disk fites and some printer files. End=af-file for 
a disk file is defined to be an attemot by the user to write past 
the declared size of the file. The dectared size of ati disk 
files is maintained in the Fide Header» a permanent entity 
created when the file is opened output for the first time. 


For files assigned to printers» end-of-file may be defined to be 
the sensing by the hardware of the physical end of the page. In 
ali casese this ts not actually the end of the pager but rather 
the sensing of a channel twelve punch in the Carriage Contrat 
Tape. This sensing wilt be reported to user programs if 
requested by setting bit one in CT~AOWERB and by setting a bit in 
the FP@ for the file. Notice thate because of the fact that the 
MCP 95 examining the rasuit of 1/0 operations which may have been 
initiated some time agor end“of-page is not reported when it 
eccurs» but “n" write operations tater» where “n* is the number 
of buffers assigned to the file. 


1/0 errors are aiso reported to user programs on the WRITE 
communicates if requested. This information ts necessarily of 
little practical use» on any Burroughs operating Systam. 
Ostensibly» the I/0 error routines of the MCPCs) shauld be af 
such a nature that the need to report this occurrence never 
arises. 


The same Data Communications applications which use bit three of 
the adverb on READ» use it in a similar manner on WRITE. When 
using this bit in the adverb» control is returned to the user 
when a WRITE is requested but the buffer that should be used is 
not yet available to the MCP. Againe this can be caused by the 
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device itsetf going not ready. 

Printer spacing information must be passed to the MCP or each 
WRITE communicate for a fite which is assigned to a printer. 


This is accomplished by setting the proper bits in the adverbs» as 
pictured in the preceding. 


Serial disk fides may be opened by the user program for both 


input and output operations. In other words» the file may be 
opened itn such a manner that both a READ and a WRITE communicate 
are acceptabler with no intervening Close and Open. Wher this 


type of OPEN communicate occurs» the MCP widl pre-fidi ali of the 
bufferse as if the file had bean opened INPUT only» but the 
buffers are reteased at different points in the READ and WRITE 
communicate processing. 


The MCP wild not move buffer pointers at the concdiusion of a READ 
communicates», as it normaiiy does. Insteader it must wait until 
the next communicate operator associated with that file is 
received. If the succeeding communicate is a WRITEr it wiil move 
the data from the work area to the buffer and change the 
operation code in the 1/70 dascriptor to a Write. Tt with mark 
the program "ready to be reinstated”*» and then rotate the buffers 
in anticipation of the next communicata operator. In this 
specifications the term “rotate the buffers” means that the MCP 
moves the necessary buffer pointers and initiates the I/0 if 
necessar ys 


If the next communicate received at this point is a WRITE>s the 
MCP, after insuring that the next buffer is available fcr user 
will move the data again» from the work area to the buffer and 
rotate the buffer pointers. If the communicate had been a READ» 
the MCP would have moved the data in the opposite direction and 
it would not have rotated the buffer pointers. 


In summary» for this type of files two successive READ operations 
wili move two successive records from the file to the users work 
areas Two successive WRITE operations will cause two successive 
records to be written into the file. A sequence of operations 
such as READ“WRITE~REABD“WRITE wild cause two successive records 
to be delivered to the user and the same records» but not 
necessarily the same data» to be written in the file. The 
Endeof-Fiie pointer for a sequential file may be extended when 
the file is opened in this manner. 


Disk files which contain variable-length records may not be 
opened for both input and output operationss or for random access 
processing. 
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For Sequentiat 1/0 fites» a physical 1/0 operation is nat 
necessarily initiated each time the user program does -a WRITE. 
For biocked files» if the user has done a WRITE on any record in 
the block» the operation will be initiated only when the buffer 
pointers are moved past the end of the block. 


For data communications fiies» the fields described as Ci.3 and 
CT.4 are used on WRITE communicates exactly as they are on READ 
communicates. 


For randow disk files a WRITE communicate may result tin more than 
one physical [/0 operation. If the file is blocked» the block 
which contains the requested record must be in a buffer in memory 
before the record is inserted in the block and actuatiy written 
to disk. This is due to the fact that the hardware can onty 
initiate I/0 operations and terminate them on segment boundaries. 


If the block which contains the requested record is not in memory 
when the WRITE is issued» the MCP will initiate a Read operations 
force the requesting user to wait for its completions move the 
record into its respective position in the block after the 1/790 
completes» aliow the user to be reinstated at this point and 
initiate the requested write operation» if the fite is being 
accessed in the RANDOM mode. 


in the 6.1 release of the softwares a file access method known as 
DELAYED RANDOM was implemented. When DELAYED RANDOM is used» the 
first request for a logical record of a given block of a GELAYED 
RANDOM file widt resuit in a physical 1/0 which reads the 
necessary biock into memory. Subsequent accesses to the block 
wid4 not generate any physical I[/0"%s as dong as the block remains 
in memory» A block is overlayed if a request is made for a block 
not currently in memory» at this time the teast recentiy accessed 
block is chosen as the one to overtay-. If the chosen block has 
been updated in memory it is written to disk before the new block 
is reads Periodicadiys» ali blocks that have been updated in 
memory are written to disk by the SMCP. 


SfEK (MICRO NEPD 


CT.~VERB 03 

CT.OBJECT FILE -NUMBER 

CT.ADVERS = 

CT.i = 

CT.2 = 

CT.3 RANDOM FILE ACTUAL BINARY DISK KEY 
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The SEEK communicate is an instruction to the MCP to position the 
arms properly» on sovable-arm devicesr and to fiil one of the 
buffers assigned to the file with the biock of data which 
contains the requested tlogicat record. This communicate is 
applicable to random disk files onty. The user is not forced to 
wait for the completion of an [790 operation initiated py a SEEK 
communicates. He may be forced to wait if there is no buffer 
available to use for the operation. 


The SEEK communicate may be used by the user programmer to mask 
some or aid of the time required by a READ communicate with 
computatione It may aiso be useder prior to a WRITE communicates 
to eliminate the necessity of waiting for a buffer to he 
pre~filied when using biocked files. 


No data is moved to or from the user's work area by the togic of 
a SEEK communicate. 


SORTER CONTROL 
CT.VERB 04 


CT.OBJECT FILE .NUMBER 
CT.ADVERS BIT 


0-4 = 

5 TRANSFER 

6 POCKET SELECT 

7 STOP“FLOW 

8 BATCH@COUNT 

9 POCKET LIGHT 

10 < 

ai ENDORSE 
CT. POCKET NUMBER 
CT .2 BASE RELATIVE TRANSFER ADDRESS 
CT.3 BIT LENGTH OF TRANSFERRED DATA 


The SORTER CONTROL communicate is used in conjunction with files 


assigned to Reader~Sorters onty. Such files may be utilized 
property in COBOL programs onty. Other tanguages may inctude 
portions of the syntax necessary for proper use of a 


Reader -Sorter» though onty COS30L contains averything that is 
necessar ye 


When the MCP receivas an I/0 Complete interrupt from the 
Reader~Sorter» it immediately references the program which is 
using that sorter» determines the memory address of the “USE 
ROUTINE work area™» and places a formatted copy of the result 
descriptor from the I/0 operation followed by an image of the 
item itself in the work area. It then reinstates the user at the 
code address of his USE ROUTINE. (For additional information on 
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Item Processinge refer to the 81900 COBOL Reference Manuals Fora 
Number 1057197.) 


The MCP takes the action described above regardtess of other 
processing that is occurring. The action described is commonty 
known as “HighwPriority Interrupt Handling". 


Only three of the five possible adverb bits may be set in a 
communicate addressed to the MCP white the user program is 
executing the USE ROUTINE. These three bits are TRANSFER, 
STOP-FLOW and POCKET SELECT. The TRANSFER bit is discussed in a 
subsequent paragraph. If the POCKET SELECT bit is set» the MCP 
will usa the value in CT.1 as the pocket number on the sorter for 
that item. If the STOP“FLOW bit is set in the adverbs the WEP 
widd atiso issue the appropriate I/0 Descriptor te the sorter. 
After receiving the communicatere regardiess of the adverb bitse 
the MCP will continue doing whatever it was doing at the time the 
interrupt was received; the user must give up control at this 
point. 


Pocket selection on the sorter thus happens asynchronousiy with 
everything that is occurring on the systems except the sorter. 
This ais currently the only device connected to the B1000 which 
operates in such a manner. The necessity for this action iis 
dictated by the fact that the sorter is actuatly a *real-time” 
device and tust de serviced in a specific time period after 4a 
check has been read by the hardware. 


The TRANSFER bit and its function was added to the 8.9 version of 
the MCP. When the TRANSFER bit is not sete which widt be the 
case for ati programs compiled prior to the 8.9 release of the 
softwares the MCP» upon receiving the POCKET SELECT communicates 
widi dispatch the pocket number supplied to the sorter controt 
and place an image of the item in a *tank™ area in memory. The 
number of ijtems that may be contained in the tank area is 
specified by the user and corresponds to the nunber of buffers 
requested for the sorter file. In actuality» there wild te oniy 
one buffer and I/70 descriptor» regardtess of the number 
requested» but the buffers requested will be used to determine 
the size of the tant area. 


Item images will be removed from the tank when the user progran 
does a SORTER READ operation on the sorter file. The images wilt 


be dedivered in sequence to the program. Dovioustys the tank 
area witdt become full if items are introduced to the system tore 
rapidly than the user program dees SORTER READ operations. If 


this occurs» the MCP wild dispatch a STOP“FLOW [/0 descriptor to 
the sorter controi,», thus stopping the introduction of items. 
Fiow wiit be automatically started by the MCP when the tark area 
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is again empty. In this manners the system prevents 


TOOLLATE_TO_LPOCKET_SELECT and TOO_LATE_TO_READ conditions fron 
occurrings 


If the TRANSFER bit is set in the SORTER CONTROL communicates the 
MCP widd not tank the actual image of the item but will store the 
data at the tfocation specified by CY¥.2 and CT.3 from the 
program*s run structure. In this manner» the user may cause the 
MCP to tank whatever he choosese thus eliminating the need for 
several orogramming steps from the user programs. A maximun of 
one hundred characters may be passed and tanked per item. 


The BATCH*COUNT bit in the adverb is used to advance the batch 
counter on the sorter by oner each time it is received by the 
MCP. This adverb bit wild only be accepted oy the MCP when the 
user program is not in the POCKET SELECT USE ROUTINE» and a High 
Priority Interrupt condition does not exist. 


Each pocket on a ReaderSorter has a red indicator Lampr visibie 
to the operators above ite The dights may be turned oan 
programaticaiiy by the object program issuing a SORTER CONTROL 
communicate with the POCKET LIGHT bit in the adverb set. Upon 
receiving such a communicates the MCP wild issue an i439 
descriptor to the sorter which will instruct it it turn on the 
light above the pocket specified by CT.1. The hardware will onty 
take such action when the fiow of items through the sorter has 
been stopped. The sage is true of the BATCH COUNT operation. 


SORTER READ CNECRO NEPQ 


CT.AVERB 05 

CT.OBJECT FILE NUMBER 

CTADVERB = 

CTwl READ AREA 817 LENGTH 

CT .2 READ AREA BASE RELATIVE BIT ADDRESS 


Check (Citem) images ara passed to the user  prograa 
asynchronously. As described above» an item image is passed to 
the program whenever one is available to the system. The user 
program is expecting to READ these images synchronoustyr however>» 
by issuing SORTER READ communicates. 


The MCP therefore temporarily stores these ifages in wsegorys 
passing them to the user program in succession» upon receiving 
this communicate. (CNotice that the user orogram has aiready seen 
the images in his POCKET SELECT USE ROUTINE.) This operation is 
commonty known as “tanking”. 
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The operation of the SORTER READ communicate is similar to that 
of READ. item images are passed to the user's work area by the 
MCP > the Length and tocation of the work area is specified by 


CT.si and CT¥.2 respectively. 


There is actuadity a secondary purpose to the SORTER READ 
communicates it informs the MCP fo the user program*s proacessing 
rate. As described abover images are passed immediately to the 
user for pocket selection but any other communicate from within a 
POCKET SELECT USE ROUTINE is prohibited. The images may not be 
written to disk or saved by the user in any manner» except when 
they are received via a SORTER READ communicate. 


Therefores if the soft “tanks* of item images maintained by the 
MCP begin to fi141 up» which iadicates that the sorter is 
delivering images faster than the user can process them» the MCP 
will automatically stop flow on the sorter until the user progras 
catches up. The sorter may therefore operate sporadicaltys» in 
bursts» but atl items wilt at least be pocket selected. 


The image of the item in the tank is preceded by a twenty-four 
digit Cninety~six bit? expansion of the actual resuit descriptor 
received from the hardware in connection with that item. This is 
passed to the user program on the SORTER READ communicates just 
as it is npiaced in his USE ROUTINE work area prior to reinstating 
his USE ROUTINE. 


Though only two communicate formats are impiemented for use with 
Reader~Sorterss the MCP must do adot more to make this operation 
possibie. A program which opens a sorter causes many different 
items to be markad non-coverfayable in nemory. This is descrided 
more fully under the OPEN communicate. For a more comprehensive 
explanation of Reader-S5orter operations refer to the 81000 CO8oL 
Reference Manuals Form Number 1057197. 


OPEN £DN2 


CT VERB 06 
CT.OBJECT INVOKE NUMBER & PATH NUNBER 
CT»ADVERB BIT 


0 INCLUDES PACKID OF DICTIONARY 
i - 
2 DMeSTATUS FORMAT 

O=BINARY 


b=4-B81T DECIMAL 

ON EXCEPTION 

UPDATE 

REQRGANTZATION € REORG ONLY) 
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CT.i DMeSTATUS REGISTER BIT LENGTH 

CT.2 DM»STATUS REGISTER BASE RELATIVE BIT ADDRESS 

CT.3 DATA BASE NAME BASE RELATIVE BIT ADDRESS 

CT o4 DATA BASE NAME SIT LENGTH 

CT.5 PACKID BASE RELATIVE BIT ADDRESS CBIT O OF 

CT.ADVERB = 13 
CT 6 PACKID 317 LENGTH C3IT 0 OF CT.ADVER® = 1) 
CLOSE {2M2 
CT.AVERB 07 


CT~OBJECT 5 
CTeADVERS BIT 


O-i - 
Z DMeSTATUS FORMAT 
Q=BINARY 
1=4-BIT DECIMAL 
3 ON EXCEPTION 
4-11 = 
CTel DMeSTATUS REGISTER BIT LENGTH 
CT 2 OMeSTATUS REGISTER BASE RELATIVE BIT ADDRESS 
OPEN 
CT.VERG 68 


CT.QBJECT FILE .NUMBER 
CT ADVERB Bil 
INPUT 
DUTPUT 
NEW FILE 
PUNCH 
PRINT 
NO REWIND/INTERPRET CDATA RECORDERS ) 
REVERSE/POCKET (CARD PUNCH) 
LOCK 
LOCKOUT 
REPORT FILE MISSING 

id REPORT FILE LOCKED 

1i BVERRIOE NAMING CONVENTION AND SECURITY 
REINSTATEMSGePTR VALUES 

0 GOOD OPEN 

1 FILE NOT PRESENT CINPUT DISK) 
PACK NOT PRESENT COUTPUT DISK) 
NO MORE FILES GN MULTI-“FILE REEL CTAPE) 
2 FILE LOCKED CODISK FILES ONLY) 


OW WOU E WwW fo ee 


The OPEN communicate serves primarily to associate a chysicat 


fite with the togicat file declared in the user's program. The 
communicate has other functions and is also used when such an 
association has aiready been made. Basicaldy>» the processing 


invoked by an OPEN communicate obeys the rudes set forth in the 
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definition of the COBOL Language. 


The object program must pass the unique file number assigred to 
the fite by the compiler in CT.OBJECT. The MCP will use this 
number to obtain the disk address of the FP3 constructed by the 
compiler for that fite. Tt with read the FPB8 into semor ye 
aiflocate memory to contain the Fila» the proper nuaber cf I72 
descriptors and the buffer areas for the file. It wiit then 
construct the FI@» based upon the information in the FPBe the 
physicadi characteristics of the device assigned to the file and» 
in some cases» the togical characteristics of an existing file. 


The memory area adiocated for a file is» axcept in the case of a 
Data Management file» a contiguous area. One memory tink cnty is 


necessary to describe a file area.» The file area witt contain 
alt of the items mentioned in the preceding paragraph. FIBs vary 
in sizer depending on the type of device assigned. No memory 75 


adlocated for this purpose until a device assignment has been 
made. 


One of the first tests made in the OPEN routine is» "Is the file 


already Open?”. This is 4a violation of the rutes of ati 
languages and the MCP has no choices if the test is truer but to 
discontinue the progran. There cannot be two consecutive OPEN 


communicates on the same file without an intervening CLOSE 
communicate. 


Another opretliminary test is » “Has a device assignment aiready 


been made?™. If trues the OPEN osrocessing follows a different 
course. Device assignment is of prime importance tao the OPEN 
routine. 


Device Assignment (Except 2isk2 


A third preliminary test is whether or not the file is to be 


assigned to disk. If the file is a disk file» the course of 
action foliowed is described under the heading “Disk File 
Assignment™. The remainder of the discussion under Device 


Assignment applies to non=disk files» that are being Opened for 
the first time. 


The next major test made by the OPEN routine is whether the file 
is being epened for input» output or both. Onty certair card 
devices» such as Data Recorderss may be opened for both input and 
outputs exclusive of disk files. Certain other combinations of 
the various bits in the advero are also illegal. These wiil be 
discussed in turn. For the case mentioned abover attempting to 
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open a card reader» for example» for output ourposes will resuit 
in the program being DS-ed by the MCP. 


If the file is being opened inputs the MCP wild attempt to match 
the external names in the FP3 of the files FPB.MULTI.FILE.~ID and 
FPB.FILE.~ID» with the labels read previousity by the STATUS 
routine on each peripheral davice. [f no match is found» the 
operator is notified and the program is forced to wait urtii a 
file with the requested label is introduced to the systems or 
until the operator resoives thea “No Fide™ condition is some other 
manner. System SPO and Controd Card syntax is available to attlos 
the operator this alternative. The program witt removed fron 
memory if possible. 


If a match is found on two or more units» the operator is 
notified of this aiso and again» the program is forced to waite 
The MCP cannot recover automaticatliy from this conditions the 
operator aust inform it that he has resolved the “Dupticate File" 
situation. Agains system SP9 jand Controt Card syntax is 
avaidable to do this. 


The MCP*s Control Card routine is invoked whenever a card input 
device goes from a Not Ready condition to a Ready condition. fhe 
routine then reads the first card from the device. If this card» 
or in some cases» a subsequent card causes a job to be scheduled 
for execution» the Control Card routine retains control of the 
MCP» reads the next card» and processes ite It will continue to 
retain controt untid the card reader goes not ready» or urtil a 
DATA card is encountered. If the Control Card routine terminates 
processing due to the encountering of a DATA cards» the physicat 
input file described by the DATA card is associated with the tast 
job which it placed in the schedules. This is oniy true if the 
Controt Card routine did not Lose controt between the time it 
encountered the card which caused a job to be scheduled ard the 
time it encountered the DATA card. 


The MCP wilt not report a Duplicate File situations if one 
existse if the input file being opened is a card fite or a 
pseudo-reader file and if the job has a physical file associated 
with it in the manner described above. Rather» the MCP merely 
aliows the associated physical file to be opened by the job» 
provided the external identifiers in the physicat tabet and in 
the FPB are equat. 


Controi Card syntax is provided to aiftow the operator to specify 
the physicad unit which contains a specific togicai fiie. This 
specificatton may be made when the job is scheduled for execution 
or it may be made permanently by modifying the FPB in the 
program"s code file on disk. lf such a specification has beer 
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made» the MCP"s OPEN routine will not attempt to match externat 
identifiers» but will simply assign the physicat file on the 
requested unit to the Logicad fila being openede provided» of 
course» that the unit is avaitable for such an assignment. It 
should be noted that making such a specification in an FPB alsa 
changes the hardware type in the FPB to match the hardware type 
of the unit specified. Units are specified by mnemonic nare. 


if the unit being opened is a tape unit» additionat tests are 
necessary before the device may be assigned. The Reel Number 
field in the unit's Label must match the corresponding field in 
the togicat filets FP8. For tape unitss Multi-Fide [dentifiers» 
Fite Identifiers and Reel Numbers must adi be equal. Also» in 
the case of a tape file» Control Card syntax is provided to aitow 
the operator to specify the Serial Number of a particular reel of 
tape. If this is done» ali four conditions must be mete As in 
the case of unit mnemonic specifications Serial Nusber 
specification may be made when the job is scheduded for execution 
or it may be made permanenti y. 


The MCP will allow tape files to be opened when the user 
programmer does not know the logical record and physicai block 
sizes actuadiy written on the tape. These fields are ieft 
unspecified in the FPB by the compiler but the defauit bit in the 
FPB>s FPOGe*DEFAULT» is turned one The recording mode of 2 tape 
file may aiso be left unspecified if the bit is set. The MCP 
widd insert the proper values into these fieids when the tape is 
opened» provided the information is present in the tape*s tabel. 
If the information is not presents the program will ba 
discontinued when the OPEN is attempted. 


The MCP wilt adso insert values for record and biock sizes when 
afi card input files are opened and FPB.DEFAULT is set. 


The MCP will discontinue any program which atterpts to opan a 
fide contained on sevenwttrack tape if the logical record size 
contained in the FPB for the file is not modulo six and if the 
programmer has specified the tape to be read without herdware 
transdiation to ESCDIC. This is true regardiess of which bit» 
input or Output» is set in the Adverb. 


When the MCP receives a request to UPEN a file for output 
purposes» one of the first itens that must be checked is whether 
or not the file should be assigned to a Backup devicere which may 
be tape or disk» If the user has requested that the file be 
directed to backup» this wild occur before the search for a 
suitable output unit is made. Backup capabilities are discussed 
in a separate part of this document. 
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Assuming that the file is not to be sent to Backup» the MCP next 
checks to see if the user programmer has requested that the fite 
have special forms for output. This test is made for alt output 
files» regardiess of davice type. If FPB.»~FGRMS is set to ones 
which indicates that special forms are required» the MCP witl 
print an appropriate message and force the program to wait until 
the operator repties in the proper manner. Syntax is provided to 
adilow this. When the operator replies» the OPEN routine is again 
invoked and the file will be assigned to the device specified by 
the operators is any» provided the unit avaidabie. 


In the absence of a Forms specification by the usere the MCP will 
search the I0QAT for an avaitable unit of the type specified by 
FPB.HOWR. As described in a prior section» certain vatues which 
this fietd may contain are not actually hardware types but 
specify a group of types» such as “any tape» "any head~per~track 
disk” and so £=forth. in order to be avaitable for output 
Purposes» the unit must be ready» must not be currentiy in use by 
another program and must be write enabled. 


If the MCP cannot find an available unit of the type requested» 
it widi check to see if it is permissible to direct the output to 
a@ Backup device. If so» it witt attempt to do so. This is atiso 
discussed in the section of this specification describing the 
Backup operation. 


If there is no available unit of the type specified by the user 
and if it is not permissible to direct the file to a @ackup 
device» the MCP witl print a message on the SPO to infors the 
operator that such a unit is required before the program» which 
witt be identified» can proceed. The program wild be forced to 
wait at this point» and will be removed from memoryr if possible. 


The MCP may recover the program from this cordition 
automaticadiys with no operator intervention. If a suitable unit 
becomes availabie for output osourposes» the OPEN commtnicate 
processing for the program will be repeated. Controt Cerd and 
Keyboard syntax is provided to altow the operator to override the 
hardware type specified in the user's FPSB. Syntax is also 
provided to aliow the operator to force the OPEN processing to be 
repeated. [In this case» the MCP merely tries again. 


The MCP wiit automaticatly discontinue any program which attempts 
to OPENe for output purposes,e a file whose hardware type 
specifies a paper tape readers areader“sorters a card reader» a 
System SPO or an unknown device. 
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Certain devices on the 81000 may be opened for both input and 
output operations. Thes? devices are ali card devices? no tape 
unit may be opened for both types of operations» except via the 
Emulator fape constructs. At the present time» there are anty 
three such devices» and they have come to be commoniy known as 
"Data Recorders™. Actually» according to the 81900 Systems 


Index» PeSs» 1904 5681» they are thes 


1. B9418-2 80-Column Keypunch-Printer 
2s B9419—"2 96-Codumn Keypunch Printer 
3s 89419-6 J9b-Column Keypunch-PrinterSorter 


Adi of the devices in the above tist have one "Wait Station”. A 
Wait Station is used for holding the physical card after it has 
been reader or at feast fed from the input hoppere and before it 
is printed or punched or both. Aili of the devices listed have at 
deast ona hardware buffers» capable of holding the information 
contained on one card. This buffer ais used on input operations 
only. “Input™ as used here will mean input to the computer. 


The tabd@e below present the number of input hoppers and output 
Stackers on each physical device. 


Device Hoppers Stackers 
CInput) (Output) 
B9418-2 2 2 
BIGII-Z 2 2 
BI419-6 2 5 


Three different 176 Controls are used to interface the devices to 
the 81000 system. They are: 


le MFCwL (P2554 2208 3034) 
Ze MFCwW2 (P2252. 2208 3034) 
3s CRPC (P.S. 2211 1371) 


The fotloxing I70 operations are defined in the appropriate 
product specification for ali af the controis, 


READ = (From the buffer in the seripheral). This operation is 
knowns for conversational purposes» as the REPEAT.READ. Watid 
Variants are: 

Stacker Select 

Inhibit Feed 

Hopper Seiect 
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STACKER.»SELECT »-AND.READ = (Read the information from the next 
card in the hopper). Valid variants are: 

Stacker Setect 

Inhibat Feed 

Hopper Sedect 


PUNCH. Vatid variants are? 
Stacker Select 
Inhibit Feed 
Hopper Sedect 


PRINT. Valid variants ares 
Stacker Sediect 
Inhibit Feed 
Hopper Setect 


PUNCH@PRINT.j Valid variants are: 
Stacker Setdect 
Unequal Data 
Inhibit Feed 
Hopper Select 


PUNCH=PRINT.~ANO.READ Valid variants are: 
Stacker Setect 
Unequal Data 
Hopper Select 


The Stacker Select variant is actualiy a threebit fietd in the 
i70 Descriptor. When the three bits are set to numeric vatues 
other than zero and seven»e the device routes the card to the 
Stacker selected by the descriptor. Valid numeric values for the 
devices range from one to Si xX. The MCP does note and cannote 
edit the numeric value passed by the object program to ascertain 
that it is valid for tha connected device. 


The Unequat Data variant is valid onty in I79 descriptors which 
cause a PunchPrint operation to be performed.~ If the variant is 
not sete» the device wii print the same information that is 
punched on the card. In other words» the beginning memory 
address for the information to be printed is the same as the 
beginning memory address for the information to be punched. If 
the vartiant is sete the information to be printed widl te taken 
from a memory tocation which immediately fodlaws the information 
that is punched. 


The Inhibit Feed variant causes the Wait Station in the device to 
be empty at the completion of the operation. No cards wilt be 
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fed from the input hoppers if this variant is set in the 
descriptor. 


The Hopper Select variant causes the feed card to be taken froa 
the secondary input hoppers» if there is one [f the Inhibit Feed 
Variant is sets» the Hopper Select variant is ignored. 


There is a dtimitatione which was mentioned briefly in a prior 
paragraph. The MCP cannot distinguish between the 89419<-2+ which 
has two output stackers» and the B9419-G» which has six. The MCP 
does not edit stacker numbers before it sends them to the 
controi. Therefore» programs which utilize all six stackers on 
the 89419"6 may not be transported to systems which do not have 
such a device. Even if the MCP could distinguish between the two 
devices» the editing would have toe be micro~coded and would 
seriously degrade performance. 


The capabilities available to tha object programmer are 
programmaticatiy selected by variants on the GPEN communicate and 
by vartants on the READ and WRITE communicates. The discussion 


is categorized according to the different types of OPEN 
available. 


When the MCP receives an OPEN request with none of the bits in 
the ADVERS area sete it will assume that the program oniy wants 
the information contained on the cards and does not intend to do 
stacker selection» Read=Punch operations» or any other variation 
available in the hardware. The I/0 descriptors constructed as 4 
resudt of this type of OPEN wall ali be of the Repeat.Read type. 
There may be any number of buffers associated with the file. Aaa 
of the buffers wiii ba filled when the fide is opened. Stacker 
Selection is not addowed when the file is opened in this manner. 


When the MCP receives an OPEN request with the Pocket bit set» it 
wilt construct one descriptors the operator fieitd of which witt 
contain a STACKER. SELECT.AND.READ instruction. The buffer will 
not be fi44ed sehen the file is opened. The first READ on the 
file will cause the first card in the data deck to be moved past 
the read head and stoppad in the Wait Station. The data from the 
card wild be transferred to the object program*"s work area before 
control is returned to the program. Stacker Select information 
passed on the first read may or may not be passed on to the 
device and wiil have no effect at ail. 


The second and ail subsequent reads shoudd have Stacker Selection 
information associated with them. The MCP will not» however» 
include code to insure this» The MCP will not adiow more thar 
one buffer to be associated with this type of file. 
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This action is distinctly» different from the most common type cf 
READ request handied by the MCP, The actual operation is adways 
issued after the communicate is received» and never pefore» as it 
is with admost alt types of input files. The I/0 operation can 
never be comdeted ahead of the demand for it. This operation is» 
however» similar to the current MCP action for Sequentiat [70 
files on Disk. The fide can actually be thought of as an 
Input/Output fiie>r for adil opractical purposes. It must be 
considered such a file by the NCP» in order for the 1/70 to be 
initiated at the proper time in a card read cycle. The QUTPUT 
bat in the DPEN adverb should never be set when the OPEN is 
requested» howevere This witdl cause the communicate to have an 
entirely different meaning. 


Quite obvioustye due to the differences in timings it is 
mandatory that the object program ciose and reopen the file in 
order to change from pure INPUT to INPUT WITH STACKERS>» and 
conversely. 


A number of variations ére possibte when the cevice is opened as 
an output fite.e There variations are: 


1. PUNCH 

Ze PRINT 

3. INTERPRET 
42 POCKET 


The Pocket variant may be applied to any of the first four 
variations» or it may be the only adverb associated with the OPEN 
Statement. The MCPe upon receiving an OPEN communicate without 
PUNCH» PRINT of INTERPRET requeastede wild assume that Punch is 
desired. Therefore» OPEN OUTPUT is equivalent to OPEN OUTPUT 
WITH PUNCH and OPEN OUTPUT WETH STACKERS is equivadent to OPEN 
BUTPUT WITH PUNCHe STACKERS. 


DPEN OUTPUT WITH PRINT means that the program does not want to 
punch anything into the cards. It onty wants to print 
information. 


OPEN QUTPUT WITH PUNCH» PRINT means that the program wants to 
punch information into the cards and wants to print different 
information on them. The MCP witl allocate the number of buffers 
requested by the programs each buffer will be 192 bytes tong. 
The MCP wid& expect to receive 192 bytes of information or each 
WRITE communicates 96 of which widi be punched in the card and 96 
of which wiil be printed. As always» it is not mandatory that 
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the program deliver the full 192 bytes. The move from the work 
area to the buffer is left-justified with blank fill. 


OPEN OUTPUT WITH INTERPRET means that the progras warts to punch 
96 bytes of information into the cards and print the same data. 
The MCP widlt allocate the number of buffers requested? which 
must be at least two» each witl be 96 bytes in Length. The 17/3 
descriptor constructed widd specify a PUNCH@PRINT operations and 
the UNEQUAL DATA bit will be set to zero. The INTERPRET reaquast 
will have precedence over PUNCH» PRINT and a combination of the 
two. OPEN OUTPUT WITH PUNCH» PRINT» INTERPRET should protably be 
rejected as a syntax error by the compilers. The MCP with accept 
the communicates however» and assume that the programmer neant 
oniy INTERPRET. The same applies to OPEN CUTPUT WITH PUNCH» 
INTERPRET and OPEN OUTPUT WITH PRINT» INTERPRET. 


The POCKET variant may be specified on any valid request for an 
OPEN OUTPUT. The variant is ignored by the MCP on the OPEN 
request. This is not true for OPEN INPUT WITH STACKERS. It must 
be true for OPEN OUTPUT» however» to avoid problems which may 
arise when the device assigned to the file is changed by a FILE 
card or an “OU" message. The WRITE communicate contains a bit 
which requests stacker selection. The MCP examines this bit and 
takes appropriate action on each WRITE communicate. 


All of the variations possibile when a file is opened OUTPUT are 
aiso posstbie when the file is opened INPUT.OUTPUT When the MCP 
receives an OPEN [NPUT.QUTPUT request with none of the variants 
set» it assumes that the user wants to read the information fros 
the cards» and punch additional information into them» and print 
the same information on then. Therefore» OPEN INPUT.OUTPUT is 
equivadent to OPEN INPUT.OUTPUT WITH INTERPRET. 


The adverbs PUNCH and PRINT are retatively useless when the file 
is opened INPUT.~OQUTPUT. Both punching and printing occur when 
the PUNCH<“PRINT.AND.READ I/0 operator is dispatched to the 
control. There is no way the device can be made to print and 
read or punch and read onty. These oapeations can be simulated» 
of courses» by setting the UNEGUAL.~DATA bit in the descriptor and 
loading the proper portion of the buffer with bianks. This 
requires some action on the part of the programmer. 


The UNEQUAL.DATA bit is set in the [70 descriptor when the MCP 
receives an GPEN communicate with both the PUNCH and PRINT obits 
set in the adverb. As in the case of OPEN OUTPUT» the INTERPRET 
bit has precedence over both PUNCH and PRINT. OPEN INPUT .QUTPUT 
WITH PUNCH» PRINT» INTERPRET should be considered a syntax error 
by the compilers. When the MCP receives such a requester 
howevers ait generates a PUNCH“PRINT.~AND-READ I[/0 descriptor with 


fe2T 


BURROUGHS CORPORATION COMPANY CONF ICENTIAL 
COMPUTER SYSTEMS GROUP Bicgoo wcPp Ii 
SANTA BARBARA PLANT PeS.e 2212 5462 (E) 


the UNEQUAL.DATA variant reset. 


Fides opened with various attributes require or can onty use 
various number of bufferse 


Attributes Requires Can Use 


Input onty» not Stackers 1 infinite 
Input only with Stackers 1 1 
Butput onty 2 infinite 
Output and Input > 3 


If the number of buffers specified for a fite is tess than the 


number required» it wiit be adlocated the number required. It 
the number specified is more than the number that can be 
effactively used» it will be adiocated only the number it can 
USQs 


As in the case of OPEN INPUT WITH STACKERSe the MCP will not fitd 
the buffers when the file is opened. The first READ issued for 
the file will cause a card to bea fad» read and stopped in the 
Wait station. The information from the card wilt be passed to 
the object program at that point. It may be necessary for the 
MEP to treat the first READ on such a file differently from ali 
other reads. This should be of no concern to either the corpiler 
or the object programmer. 


After the first READ on the filer the MCP will normally expect to 
receive two communicates for each card passed through the device. 
There shold be one WRITE request and one READ request for each 
physical card. The program should pass 96 bytes» or 192 bytes» 
of information to the MCP on each WRITE request. The information 
wilt be moved from the program*s work area to the buffer on the 
WRITE communicate. The ectuat [70 operation will be initiated at 
this tine and the program will be altowed to continues Without 
Waiting for the completion of the operation. 


The MCP wilt normadly expect to receive a READ communicate at 
this points and the program may be forced to wait for the 
compietion of the I/0 operation issued previousiy. After 
comptetions the information read from the card will be passed on 
the READ communicate» as always. 


it is not mandatory that the program always follow the REAC/WRITc 
sequence described in the foregoing. if the program issues twa 
successive WRITE requests» the input information on one of the 
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cards invotved witi be tost to the program. The consequences if 


a program issues two successive READ requests are somewhat more 
dire. The inforwation punched and printed on the first card wilt 
atso be punched and printed on the second. Though this sounds 
rather bad» this coudd possibly be of some use to someone. 


Since thea actuad I/0 operation for this type of OPEN is initiated 
on the WRITE communicate» any stacker selaction information sust 
be passed along with the WRITE communicate. Stacker information 
nassed on the READ will be ignored. 


The MCP widd automaticaliy discontinue programs that attespt to 
OPEN a file on any of these devices if: 


i» Neither the Input bit nor the Dutput bit is on in the 
Adverbs» 


2. oth the Print and the Interpret bits are on in the adverb» 
offer 


32 The program is attempting to use a 96-cotumn device in the 
binary recording mode. 


Disk Eile QPEN 


When a user program attempts ta DPEN a file which is assigned to 
disk» the first test made in the Open Routine is whether the fite 
is a new fite which the program is creating for the first time or 
an otd file which already exists in the disk directory. In the 
first case» a disk file header witd eventually be constructed in 
memory by the OPEN routine. In the second case» the disk file 
header already exists and is stored in the directory and wiit 
have to be obrought into memory by the Routine. The Open 
procedure for a new file wild be discussed first. 


Programs which attempt to open new files for input and output in 
the serjal access sode widd be automatically discontinued ét this 
points Also» programs which attempt to open a new MNuiti-Pack 
Fite and have blanks in the PACK.~ID field or the FPB will be 
automaticaily discontinued. 


If the Open communicate specifies that the file is a code fite>» 
the proper names for the file will be stored in the FPS at this 
point. <Ailsor the number of disk areas requested in the FPB wiilt 
be automaticadiy set to one. The fact that this is a code fiie 
will be recorded sy the MCP in the FPSB for the fite. This 
information is required whan the file is closed. 
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If the PACK.~.ID field of the FPB contains something other than 
EBCDIC blanks» the program is requesting that the fite be 
directed to a user pack with that ID. The MCP wilt» at this 
points examine the Pack Information Table maintained in memory 
for a pack with the corresponding identifier. If such a pack is 
present on the system» the routine continues. Otherwise» if the 
user has requested that he be notified when the pack is not 
present by setting the REPORT FILE MISSING bit in the adverbs he 
wi4d be so notified at this point and controd will be returned to 
the user through the normadi processor queue mechanisas. 


If the REPORT FILE MISSING bit £5 not set» a message to the 
operator wilt de displayed and the program wiit be suspended 
untid the requested pack is introduced to the system or the 


operaor overrides the PACK.1D specified. Control syntax is 
provided to addon the operator severat means of accoapnlishing 


If the fide being opened is a multipack file and if the seriat 
number of the physical pack is zero or if the pack is atready a 
continuation pack for another mudtipack file» the program witli be 
automaticaily discontinued. If the number of areas requested for 
the file by the programmer is greater than 1055» it will be 
automaticaity set to 105 by the MCP. In the tatter case» no 
warning is sent to the operator. 


Memory for the file header is aldocated at this point. If the 
user had requested that the disk areas to be assigned to the fite 
be atliocated when the file is opened» the attocation is done at 
this points provided sufficient disk is avaitable. If sufficient 
disk is not avaidlabties the program is suspended and an 
appropriate message is displayed on the SPO. 


The File Header is nox constructed in memory» based upon 
information contained in the FPB. The uitimate dispensation of 
the header is dependent upon the type of CLOSE communicate 
performed on the file. 


At this point in the OPEN processing» the logic becomes the same 
for new and old fiies. Sefore proceeding with a description of 
the togic at this pointy it wilt be advantageous to describe the 
processing which occurs when tha user opens an existing fiie. 


When the user requests an Open of an existing files the first 
occurrence is a deternmination of whether or not the file is 
present on the system. Ali three names in the FPS must match an 
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existing fiite if the name fields contain something other than 
EBCDOIC blanks. 


[If the PACK.I0 Fieid is bianks the file is assumed to reside on 
system disk. The directory on the system disk wiid be searched. 
If the PACK.ID fieid is not bianks» it specifies that the file 
exists on a removable user pack of that name. [If there is no 
such pack on the system at that time» the program is suspendedr 
with an appropriate operator messager untit the pack is 
introducad to the system or the operator overrides the PACK.ID in 
the FPB. There are several means provided for the operator to 
accomplish this If the REPOGRT.FILE-MISSING bit is set in the 
communicate adverbs the program is not suspended» but controt is 
returned to it through the normal processor queues and the fact 
that the pack is not present is reported to it. in either case» 
the OPEN cannot proceed past this point. 


After the decision above» the MCP next searches the directory on 
system disk or on a user pack for a file identified by the namas 
in FPB.MFID and FPB.ID. If the file is not founds the action is 
identicai to that described above. If the file is found» further 
decisions ara necessary. 


If the LOCK bit is set in the OPEN adverbs there may be no other 
users who are writing to the file. There may be other users of 
the files but none of them may be using the file for cutput. If 
the LOCKOUT bit is set in the OPEN adverbs there may 62 no other 
users of the file; the user who is presently cpening the file 
must be the sole user. If these conditions are not met» an 
operator message is dispiayed and» depending upon the setting of 
the REPORT FILE LOCKED bit in the adverbD» the user is either 
suspending or notified of the condition. 


Assuming that aati of the conditions specified are met 
satisfactorily» the File Header is brought into memory by the 
MCPs af it ts not there aiready» and the user count field in the 
header is incremented. if the BDUTPUT bit in the adverb is set» 
the output user count field is aiso incremented. 


At this point in the OPEN processing» ati of the paths converge. 
If the file is not a disk file» a device has been assigned to it. 
If the file is a disk file» the File Header is in memory and its 
associated disk areas» if any» are essentiatiy “assigned” to thea 
file. The File Information Block CFIB) must now be constructed. 


Construction of the FIB is a rather mechanical process. After 
initializing certain fields in the I/70 Assignment Table (CIOAT)> 
memory to contain the FIB is allocated» if this has not aliready 
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occurred. As mentioned in a prior sections the amount of semory 
allocated for an FIB is dependent upon the type of device 
assigned. 


The FI8 itself is constructed from information contained in the 
FPB» from information in the Disk File Headerr and froma the 
parameters passed in the OPEN communicate. After this occurse 
the I/0 descriptors are constructed. Memory space which contains 
the I/0 descriptors and their associated buffers is atiocated 
with the FIBs such that the FISB contains not only the file 
information but adiso the descrintors and buffer areas. The 
memory necessary is then a contiguous block. This statement does 
not appty to Data Management System buffers» which are atiocated 
separatedy. 


For seriai» input ondy fides» sach [1/0 descriptor is initiated as 
it 35s constructed. The buffers are hence “pre-filied™ by the 
operating system when the file is opened. This is true of ad 
files except those assigned to a reader-sorter and those assiqnes 
to a data recorder where the user has specified that stacker 
selection is to be performed on tha cards. 


For output fides which are not assigned to disks tabeis are 
constructed and written according to the user*s specifications. 
Tape tabets are discussed in the portion of this document which 
describes Magnetic Tapa Management. For input files» the device 
assigned wilt be positioned such that the first READ issued by 
the program yeilds the first physical record from the device. 
This is often accompiished by the Open routine. 


If the user has requested that translation be performed by the 
softwares memory to contain the Transtation Tabie specified by 
the user is adiilocated by the Open routine. The Transtatioan Tabla 
is aiso brought into memory by the Open routine and pointers to 
it are constructed in the Fi. If the specified Translation 
Table is not present on disk at the time of the Opens the progras 
is suspended and an appropriate operator message is dispiayed. 


If the LOG System Option is set» entries are made in the tog when 
the fite is opened. The FPB for the file is aiso the dog entry 
and certain fields therin are updated and modified. At the 
conclusion of the Open processing» control is returned to tha 
user if OPEN was invoked by a communicate. In ati tanguages 
except COS8OL» OPEN may be invoked by a READ» WRITE or SEEK 
communicateae If this was tha case» control is returned to the 
appropriate communicate handder via the systems processor cueues. 
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£LOse 
CT»VERB 09 


Cr.QBJECT FILE »NUMBER 
CT»ADVERS Bit 

REEL 

RELEASE 

PURGE 

REMOVE 

CRUNCH 

NO REWIND 
QVERRIDE NAME CONVENTION AND SECURITY 
LOCK 

IF NOT CLOSED 
ROLLOUT 

AUDIT SWITCH 
TERMINATE 


pe 


The CLOSE communicate adlows the user to specify the dispensation 
of files that he has created.» Should a program terminate xithout 
performing a Close on any fite that he has opened» the MCP will 
assume that the device assigned to the file is to be returned to 
the system*’s resources and that the data contained in the file 
should not be retained. 


A second purpose of the Close routine is to bring the I/6 
activity on a device» which happens somewhat asynchronously with 
@ program's processing» to an orderly hatte. It aiso returns any 
memory assigned to the file to the system. Clearly» an [#6 
descriptor and buffer area cannot be returned to availabte memory 
until the I/0 operation it dascribdes is connpiete. In order te 
accomplish this» it is often necessary for the Close routine to 
give up control of the processor and regain it when certain I[/3 
operations go to completion. 


The first test performed by the Close routine is whether or not 
the file has ever been opened. A CLOSE communicate issued for 
such a file is considered a programming error and the proygraa 
widad be discontinued at this point. This ais done primarity to 
inform the object programmer of the fact that there is something 
is wronge 


The second test performed by the Close routine is whether or not 
the file is open now. It is considered a programming error if a 
user requests a Ciose on a file that is already closed» as 
opposed to never having bean opened» if the IF NOF CLOSED bit is 
not set in the CLOSE communicate adverb. The program witt 6a 
automatically discontinued if this error is detected. If the IF 
NOT CLOSED bit ts set in the adverb and the fite is already 
closed» control as returned to the user program through the 
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normal processor queue mechanisa. A@i other bits in the adverb 
wilt have no effect and the file is not closed a second time. 


Before proceeding with a description of the mechanics of the 
CLOSE communicater it will be beneficial to explain the function 
of the various bits in the adverb. The REEL bit is used on files 
which are assigned to magnetic tape only. It is ignored by the 
code if the file is assigned to any other device. It causes the 
MCP to close the reel of magnetic tape that is currently being 
processed. The fide will be closed and the reel will be Locked 
by the MCP. if the user program issues another OPEN communicate 
for the file» the next reet of the file» in numerical. sequencer 
wild be sought by the Ooen routine. 


It is not necessary for the user program to issue CLOSE REEL 
communicates when the physicad end of the reel is encountered. 
This is done automaticaidiy by the MCP. Reet-tortreetl transition 
is accomplished without the involvement of the user program. 


The RELEASE bit in the adverb means that the resources assigned 
to the file are to be returned to the systes. New disk files 
which are closed with RELEASE will have their assigned disk 
areas» if any» returned to the List of available disk. Permanent 
disk fides which are ctosed with RELEASE wild have their user 
count fieids decremented but wild remain in the disk directory. 
Devices other than disk will be marked availabie for use by other 
jobs» provided their physical status permits. 


The PURGE function is applicabde to files assigned to disk or 
tape oniy. It is ignored if the file is assigned te other 
devices. If a CLOSE PURGE is performed on a file which is 
assigned to a tape unite the tape reei will be rewound and 
purged» provided it is write~enablted. If it 1s not 
write~enabled» CLOSE PURGE wilt be equivatent to CLOSE RELEASE. 
For a parmanent disk file which is closed with PURGE» the file is 
removed from the directory» provided the user who is doing the 
CLOSE is tha sole user of the file» and the disk space assigned 
to the file will be returned to the available tabte. A new disk 
filer often known as a “tamporary” file» wiil not yet be entered 
in the disk directory» but the disk space assigned to it wit be 
returned to the availab@ie table also. In the case of a tenporary 
file» there can be only one user and it is not necessary to check 
user counts before purging. 


The LOCK bit in the adverb is intended to be used on files which 
are assigned to disk and tape oniy. It ts ignored if the file is 
assigned to other devices. When a file assigned to tape is 
closed with LOCK» the tape reei is rewound and the unit's status 
is marked as "*Locked*” in the [QaT. The unit will not dea 
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avaiflable for use by other jobs until the operator intervenes» 
either by making the unit not ready and then making it ready or 
by antering a “Ready” message on the SPO. The intended purpose 
of this function is to prevent the MCP from assigning the unit to 
other jobs before the operator has had a chance to remove any 
tape files which may have been created on the unite 


The LOCK bite» when set on a CLOSE directed to a file which is 
assigned to disk» causes the file to be entered in the disk 
directory if it is a temporary fila» subject to the restrictions 
below if the file is a permanent file which is already in the 
directory» the LOCK function is equivalent to the RELEASE 
function. 


A file may not have its name entered in the disk directory if 
there is adready a file by that name in the directory. A user 
who attempts to CLOSE LOCK a fite»s the name of which is already 
in the directory causes what is known as a “Dupticate Library" 
conditione The program wild be suspended at this point and an 
operator message describing the conflict will be displayed. The 
operator must intervene at this point and cause the existing file 
to be removed» or instruct the MCP to change the CLOSE LOCK 
communicate to a CLUSE PURGE or CLOSE RELEASE. Syntax is 
provided to adiow this. 


The REMOVE bit in the adverb is intended to ba used on disk files 
onty. Its function is to atlow temporary disk files to be Closed 
with LOCK without operator intervention. It operates in a manner 
simidar to CLOSE LOCK except that if a Oupticate Library 
condition arises» the existing file is removed from the directory 
and the disk space assigned to it is returned to the avaitabte 
table automaticaidi y. The function is performed by the MCP with 
no oaperator intervention required. The new disk file is then 
entered into the directory and control is returned to the user. 


The CRUNCH bit in the adverb was originally intended for use by 
the compiters. This restriction is not enforced» howevers and it 
may be used by any program whose source language inciudes the 
construct necessary to set the bit in the Cogmunicate format. 
Its purpose is to return any disk that was requested but not used 
by the file to the available disk tabte. The unused disk must 
die beyond the Endwof-Fite pointer for the file and the file may 
have no more than one disk area assigned to it. When a Ciose 
with CRUNCH operation is performed on a filer» always iin 
conjunction with the LOCK bite the number of segments per area in 
the file header is modified by the Ciose routine such that it is 
exactly equai to the amount of disk used. The header is then 
written to disk» per the LOCK bit» and the unused space is 
returned to the system. 
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The NO REWIND bit when set is applicabte to magnetic tape files 
ont ye It causes the magnetic tape to be positioned immediately 
beyond the tast tabel racord written. The unit remains assigned 
to the program and is not avaitlabie for use by anyone elise. The 


user then has the option of opening another file in tha forward 
direction» thus creating or continuing a mudtisfile tape» or of 
opening the file just written as input in the reverse direction. 


The IF NOT CLOSED bit atiows a user to close a file that is 
atready closed. Ordinarily» this is a programming error and wiil 
resuit in the user*s being terminated by the MCP» as described in 
a prior paragraph. This bit is merely a means of avoiding 
termination. 


Fide Information Blocks» I[/0 descriotors and buffer areas require 
substantiai amounts of memory. The ROLLOUT bit in a CLOSE 
Communicate was provided to altow a user to temporariiy close a 
files leaving the associated device assigned to the programs and 
have the FI8 stored on disk so that it does not waste memory 
spaces then the file is reopened» it is merely a matter of 
reading the FI8 in from disk» updating certain fieids therine and 
proceeding» This is often quicker than recreating the entire FIs 
and it elimiates the possibility of another program gaining 
control of the peripheral device in the interim. 


The TERMINATE bit in the CLOSE adverb is set when the MCP’s 
termination routines cali the Close routine. This occurs onty 
when a program terminates» normally or abnormaliy» and the 
peripherat devices are stiitl assigned to the program. 


The MCP insures that the external names associated with a file 
assigned to disk are proper names when the file is closed. dhen 
a compiter ciosas the code file it has generated» the externai 
names of the file are inserted by the Close routine based upon 
information supplied by the user in the Compile Control Card. 
Alsoe the MCP will not allow a disk file to be closed with LOCK 
with a btank mudti-fite ID. The internat name of the file will 
be inserted in FPB.»MFID and an operator message will be printed 
when this is attempted. 


The FPB.LOCK boolean» if set» witd cause the LOCK bit in the 
CLOSE adverb to be turned on whan the file is closeds provided 


the TERMINATE bit ais ahso set. This causes the fite to ba 
entered in the disk directory and was added as an aid to 
debugging. Occasionaltys when a program has a fatai error» disk 


fiites that the program was using at the time are hetpful to the 
object programmer in determining what caused the error. Locking 
the file in the directory enables the programmer to took at the 
data he was processing when the error occurred. 
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The CRUNCH bit in the adverb wilt be turned on automaticaily by 
the MCP if the file being closed is a backup filer» a pseudo~deck 
or a code file. The LOCK bit witl be turned on if the file is a 
backup file or a code fide and if it should be entered in the 
directory. This latter case can onty be determined from 
information contained on the Compile card which is not readity 
available to the compiter. 


Any file which was opened with the output bit set in the OPEN 
adverb» any file to which the user may have been itssuing WRITE 
communicatess requires some special attentian by the MCP during 
the Ciosa procedure. Since physical I70 operations happen 
asynchronousty with the user programe output I/0 operations may 
have been initiated or marked ready for initiation and be 
incomplete or not even in process at the time the MCP receives 
the CLOSE communicate. The actuai Close operation must therefore 
wait for the completion of ali output I[/0 operations associated 
with the fide that is being closed. 


input fides present some similar probtems. Since att of the 
user's buffers are filled waen the file is opened» provided the 
file is accessed serijiaily» and since the MCP attempts to stay 
ahead of the user program in initiating I/9 operationse as soon 
as the user has read ail of the records from a buf fer> physicat 
1/0 operations may be in process or marked ready for initiation 
when the file is closed. In the case of an input filer it is not 
necessary for the MCP to wait for I70 comptetion. Any operations 
which have not been physically initiated may be cancetied by 
removing them from the channel chain. The MCP must wait for the 
comptetion of any I/0 operations that are already physicaity in 
process» but this is a relatively short time period. 


in the case of Sequential I/0 and Detayed Randows disk files» the 
data in the buffer may have been aitered by a Write operation 
from the user but the [/0 descriptor may not yet have been marked 
ready for initiation. The Close routine witi insure that att 
such buffers are actually written to disk priar to the completion 
of the Close operation. Simitarty» for seriat» biocked output 
files» the user may have done several write operations but not 
yet fitted an entire buffer. The I/0 descriptor in this case 
also wiil not yet be marked ready for initiation but the buffer 
witl contain data which must be written to the physical media. 
The Close routine widd initiate ait such operations and insure 
that they are completed satisfactority before allowing the file 
to be closed. 


In order for the events described in the oreceding paragraph to 
occurs the physical media must remain accassibie. In other 
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words» if the unit goes not ready and there are [/0 operations 
which must be completed before a Cieose can occurs the program 


will remain in a waiting condition until the unit goes back to a 
ready condition and the necessary operations are complete. 
Keyboard syntax is provided» however» to aliow the operator to 
override this restriction. The syntax shouid be used only when 
the user program is being aborted. The output data in the 
buffers will be Lost if the syntax is invoked and the data in the 
fite will be suspect. Further» if the device is a magnetic tape» 
the MCP widl not be able to write closing tape marks and tabeis 
on the media and an I[/0 error witli resutt when the tape is read. 
Possibly» no I/70 error wild result» which may be worse. 


The Close routine next begins operations which are depandent upan 
the type of device assigned. in the case of a card reader which 
is closed by a usere the device may contain cards which have not 
yet been read by the program. The MCP wild cause the cards to be 
passed through the reader» stopping when the device goes not 
ready or when the next controd card is ancountered. 


In the case of a reader~sorter» code segments would have been 
marked nonsovertayabie in memory when the file was opened. fhese 
code segments wilt be marked overtayable by the Ciose routines 
provided the user who issued the CLOSE is the sote user of 42 
sorter. Readerwsorter files may onty be closed when the flow ot 
documents is stopped. Also» they may oniy be Closad witha 
Redease. The MCP widd interpret aii Close operations on sorter 
files to be Close with Release» regardiass of the setting of the 
RELEASE bit in the adverb. 


By far» the most complicated orocessing occurs when the file is 
assigned to disk. If the file is a multipack filer the fase Pack 
must ba onwtine at the time of the Close. The Close procedure 
will not proceed past this point if it is not. 


The MCP next atterapts to do the LOCK function described 
previcusily. New disk files witli be antered in the disk 
directory» provided there is no file with an adentical nase 
already in the directory. 


Existing fites in the disk directory cannot be removed under any 
circumstances if they are in use. Similarly» files classified as 
"System” files cannot be removed» even though their user~count 
fieid in the disk header is zero. The MCP code file being used 
is an examptie of such a file. Existing files wild be removed by 
the Close routine if the REMOVE bit is set in the CLOSE adverb or 
the RM¥O¥ system option is set» if the Close routine encounters a 
duplicate file in its processing. If neither of the above 
conditions are true» the program wilt be suspended at this point 
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and the operator sust intervene to resotve the conflict. 


lf the file is a permanent file and if the user has added records 
to the file white it was opener the end-of-file oointer in the 
fide header wilt be adjusted by the Close routine. 


If the PURGE bit is set in the adverb and the file is a permanent 
file or if the file was temporary and is being Closed with 
Releases the disk space used by the file is returned to the 
avaitabie tabie. 


If the file being closed is assigned to tape» the Close routine 
writes tape marks and iabels on the tape. Aiso» the Close 
routine sends a rewind descriptor to the units» if not prohibited 
by the type of Ciose being performed. 


The information in the IQAT is undated by the Ciose routine. 
Test and Wait for Raady I/0 descriptors are retinitiateds if 
appropriate. Aid of the user*s I/70 descriptors are removed from 
the I/O chain. 


information in the FPB dis updated and stored on disk in the 
working copy of the FPU. Finatiy» the mamory assigned to the 
file is returned to the systea*s avaitabie mencry. Control is 
returned to the user through the normal processor queue 
mechanis@ss» 


POSITION (MICRO HEP CBACKUP FILES ONLY22 


CT.~VERB 10 
CT.~OBJECT FILE sNUMBER 
CT.ADVERS BiT 


0 REPORT & RETURN TO USER ON EDF 
i REPORT & RETURN 70 USER ON PARITY 
2 REPORT & RETURN TQ USER ON INCOMPLETE 170 
3-7 
8 POSITION TO END OF FGLE 
9 CT.wzi CONTAINS PRINTER CHANNEL NUMBER 
19 CT.~1 CONTAINS RECORD COUNT AS A FIXED NUMBER 
ii CT-i1 CONTAINS RECORD NUMBER BDESTRED 
CT.i DEFINED BY BITS IN CT.ADVERB , 


REINSTATE.MSGePTR VALUES 
0 GOOD POSTTION 
i END OF FILE (OR END OF PAGE ON PRINTER) 
2 I/O ERROR 
3 INCOMPLETE 170 
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The POSZTION communicate allows the user to change the physica 
and togicat position on a file. it is used with seriat files 
oniy» of course. The file may be assigned to disk» tape or to a 
printer. The communicate is ignored if the file is assigred to 


any other device. 


Positioning a printer file wilt be discussed first. If the 
POSITION communicate is directed to a printer file» CTo-1 wilt 
contain aither a channel number which wild correspond to a punch 
in a carriage control tape» or a number which witli specify the 
number of dines the printer shoutd be spaced. If bit 10 in 
CTeADVERB is one» CTel will be assumed to cantain the channet 
number » If the bit is off» CY.1 will be assumed to contain the 
number of dines. 


The Position routine wilt atways space the printer the number of 
lines requested. Due to the design of the 81000 Printer 
Controls» it spaces the printer two lines per descriptor ands if 
the number of Lines requested was an odd number» issues @ space 
operator for one tine to complete the operation. if ae channeit 
twedve punch in the carriage control tape is reported anytime 
during the spacing» Endtof-page is reported to the progras when 
the operation is complete. it is therefore possible» though 
highly inefficient» to cause several pages of paper to be passed 
through the printer with one POSITION communicate. End=cf-nage 
is always reported to the user» if it was reported to the MCP» 
regardless of whether of not he has included code to handle the 
situation. Programs are not automaticaify discontinued if there 
is no such code. 


If cT.i contains a channet number» and if the channel nugber is 


less than twelve» the routine constructs and sends an I/0 
descriptor to cause the printer to space to the recuestac 
channel. If the channei number if CYT.1 is twelve or greater» 4 


message is printed on the SPQ and the communicate is ignored. 


With some restrictionse disk files may be positioned forward or 
backward a specific number of records or they may be positioned 
to a specific record number within the fite or they may be 
positioned to the end of the file. The file may be opened (for 
input or for output but it may not be opened for both. 


Random disk files and files with variable tength records may not 
be positioned at ati. Attempting to do so wild resuit in the mCP 
automaticaity discontinuing the program. 


Input disk files may be positioned to the end of the file» out 


may not be positioned beyond. Attempting to do so will resutt in 
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the file being positioned to the end of the file. Outnut disk 
files may be positioned beyond the end-of-fite pointer but may 
not be positioned beyond the dectared physical bounds of the 
file. The "declared physicat bounds" of a fite are the nusber of 
records per area declared times the number of greas in the file 
declaration. 


Fides may not be positioned to a negative record nusber. 
Attempting to do so wilt resuit in the file being positioned to 
the first record in the file automaticatiy. 


In ail cases mentioned aboves the first bit in the adverb sust be 
sete Attempting to position a disk file to or beyond the 
endwof-file pointer or to the first record in the file or a prior 
record wiitt resuit in the MCP automaticaidy discontinuing the 
program if the Report and Return EGF bit is not set. This is 
applicable regardiess of whether the file is opened for input or 
output purposes. 


Files assigned to tape may aiso be positioned forward and 
cackward,s provided the file does not contain variable-tength 
records. Attempting to position such a file wild result in the 
program being discontinued by the MCP. Aisoe tape files wili be 
positioned to the first record in a file or to the 
end-ofe-the-file» provided the first bit in the adverb is sete in 
the same manner as disk files. 


In order to function properly» the MCP maintains a record count 


for adi tape files ona “per reei" basis. When the Pasition 
routine raceives the comaunicate» it first computes the recore 
number desired by the program. If the record count desired 


exceeds the current record counts the tape is positioned in the 
forward direction to the desired record, 


The record count for any reel of tane is set to zero when the 
file is opened. This is applicable regardtess of the type of 
Close previously performed on the filer if there was a prior 


Closee Hences when a tape reel is opened in the reverse 
directions Record One is actuality the tast physicat record on the 
tape. The "forward" direction is therefore defined to te the 
direction that the tape is currently being passed. When a fide 


is opaned reverser a “Backspace” operation wilt cause it to move 
toward the physical end of the reel. 


Tape fites may not be positioned to the end of the file if the 
file is opened output or if it is opened reverse or if it is not 
an ANSIIsdabedied tape. When a Position to end-of-fiile occurs» 
the record count field maintained by the MCP wild be lost» since 
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the I/0 operator addressed to the unit wilt be a "Space to Tape 
Mark”. The record count field must therefore be recovered from 
the ending tabet and ANSII tabels are the only tabets which 
guarantee that a record count field is present. 


The B1000 tape subsystem is capable of spacing tape one  ghysicat 
record per I[/0 operation or to a tape mark. [It is not capable of 
spacing for a specified number of physical biocks with ore [7/0 
descriptor. Hencer spacing to a specific record occurs one biock 
at a time. Irrecoverable [/0 errors encountered on any of the 
blocks widi result in the program’s being automaticaity 
discontinued by the MCP if the second bit in the adverb is not 
sets. If the second bit is set» the [/0 error will be reported to 
the program and the position communicate will be terminated. At 
this points the record count field maintained by the MCP will not 
be retliabie. 


If a tape mark is encountered white the MCP is spacing the tape 
to a specific records Endwof-File will be reported to the progran 
if the first bit in the adverb is set. The program witi be 
automaticadliy discontinued if it is not. 


ACCESS FILE PARAMETER LOCK CEPBD 


CT.VERS ii 
CT.OBJECT FILE NUMBER 
CT.ADVERB 81T 


o-10 - 
11  0=READ 
1=WRITE 
bist RECELVING FIELD BIT LENGTH 
CT.2 RECEIVING FIELD BASE RELATIVE BIT ADDRESS 


The ACCESS.~FPB Communicate aillows the user access to any of his 
File Parameter Biocks. The working copy onty cf the FPB way be 
accessed by this communicate. The FPS is read directly from disk 
into the user's run structure. The address and size passed in 
the communicate must tlie wholly within the run structure. The 
program witli be automaticadly discontinued By the MCP if this 
rule is violated. 


Inforwation is not formatted by the MCP. if the FPB definition 
in the MCP is changed for any release of the software» it is the 
user*s responsibility to make corresponding changes in his 
progran. 


The communicate operation is ignored if CT.O08JECT spacifies a 
file which is nontexistent or if the user attempts to read less 
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than 56 bits of an FPS. 


Changes made to the FPB while the file is open witt rot be 
effective untid the fide is opened again. Due to the fact that 
the Close procedures use fieids in the FPB» changing a Fle 
Parameter Biock while a file is open may resudt in unpredictabdte 
errors and even system halts. 


ACCESS EILE INEQRHATION BLOCK (F132 


CTs#VERB 12 
CT.OBJECT FILE .NUMBER 
CT»ADVERB BIT 
0-19 = 
11 FORMAT 
O=CHARACTER 


1=BINARY 
CTol RECEIVING FIELD BIT LENGTH 
CT.2 RECEIVING FIELD BASE RELATIVE BIT ADDRESS 


The ACCESS.FI8 communicate does not reaily access the entire FI. 
It returns only the Endtof-File pointer and the type of hardxare 
device assigned to the file. It returns these items in either 
binary or decimad format. The Endwof-Fide oointer is twenty-four 
bits or eight bytes. The hardware type is six bits or two bytes 
respectively». 


Programs widd be automaticaliy discontinued if the receivirg fiie 
is not whoity contained within the program's run structure. An 
ACCESS.~FI8 communicate for a fite that is not open will be 
ignored. 


DATA OVERLAY 


CT.WERB 13 
CT»O8JECT BASE RELATIVE BIT ADDRESS OF 765 BIT FIELD IN FORMAT 
4 OBITS ss 


24 BITS BEGINNING ADDRESS 
24 BITS ENDING ADDRESS 
24 BITS RELATIVE OLSK ADDRESS 


This communicate is issued by programs which are written itn SOL 
and which inctude paged arrays onty. The SOL Compiter generates 
code which manages the paged array space and this communicate is 
the means whereby it transfers information in the paged arrays to 
and from disk. 


OF 
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The area described by the fields Listed above must die whoity 
within the program’s run structure. Violation of this rule will 
resudt in the automatic discontinuation of the program. 


The ralative disk address passed must lie within the disk oavertay 
ar ea adiocated to the oprograg. This has been discussed 
previousdy under program 803 facilities. 


Due to hardware dimitations» the overtay area can be no smatter 
than 56 ba tS 


This communicate is not used by COBOL» RPG or any other progran 
written in a source language other than SDL. 


This communicate uses the program's overlay descriptor in the Run 
Structure Nucteuse The program is placed in the WATT» untit the 
If/0 operation initiated by the oerocedure goes to completions At 
that time» control is returned to the program through the normat 
processor queues. 


ACCESS DISK EILE WEARER CDEHD 


CTVERB 14 

CT~OBJECT BASE RELATIVE ADDRESS OF 30 CHARACTER FILE ICENTIFIER 2 
PACK.I1D CAT MFID CAT FID 

CT»~ADVERS BIT 


6 OVERRIDE USERCODE NAMING CONVENTION AND SECURITY 
7 REPORT SECURITY VIOLATION 
R-9 - 
10-11 O=WRITE 
1=READ 


2=READ & FORMAT IN BINARY 
3=READ & FORMAT IN CHARACTERS 
CT.1 RECEIVING FIELD BIT LENGTH 
CT.2 RECEIVING FIELD BASE RELATIVE 8TT ADDRESS 
REINSTATEMSGePTR VALUES 
0 COMMUNICATE COMPLETE 
i FILE NOT PRESENT OR SECURITY WIOLATION AND 
CTeADVERB BIT 7=0 
2 SECURITY VIOLATION AND CT.ADVERB BIT 7=1 


This communicate atiows the user access to disk file headers 


contained in the system*s disk directory. The receiving or 
sending file described by CT.1 and CT.~2 must tie within the 
program*s run structure. If it does note the program wilt be 


automatically discontinued by the MCP. The field in the run 
structure which specifies the file identifier must be exactly 
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thirty characters in tength and must conform to the fixed format 
described in the Communicate tayout above. 


This communicate has four variations as defined by CTeADVERB. If 
CT-ADVERB contains a zero or a one» the sending or receiving 
field is assumed to correspond exactly to the current definition 
of a disk file header. The “current™ definition means the 
definition used in the actual MCP that is handling the 
communicate operators and mot the definition used in any 
subsequent MCP. 


If CT.ADVERB is set to zero» certain fields are moved from the 
program’s run structure to the actual disk fite header and 
Written to the disk directory. Oniy selected fields may be 
written? those not selected are ignored. 


If CT.ADVER3 is a ones» information is moved directty from the 
file header to the receiving fietd specified. The #ove is 
Left-justified with zero fiil. The entire file header may be 
read in this manner. 


If CTe-ADVERSD is a two or a threes the fields tisted in the table 
below only are moved to the oprogram’s run structure. The 
formatted move adso occurs teft-justified with no filling. If 
the receiving fieid is not sufficiently tong» the move is merety 
truncated from the right. 


FIELD NAHE LENGTH LENGTH 
(BITS) (CHARACTERS) 
DPEN.TYPE 24 1 
NO.~USERS (Number of Users) 24 2 
RECORD.~SIZE 24 & 
RE CORDS.~jPER.jBLOCK 24 4 
ENF.POINTER 24% B 
SEGMENTS»PERAREA 24 a 
USERS.~OPEN.OUTPUT 24 i 
FILETYPE 24 2 
PERMANENT 24 i 
BLOCKS.PER.AREA 24 6 
AREAS»RQST (Requested) 24 3 
AREA»COUNTER 24 3 
SAVE.FACTOR 24 3 
CREATION.~GATE 24 5 
ACCESS.~DATE (Last) 24 5 
REC.SIZE - 5 
MPF {Muiti-Pack Fite) i 1 
PROTECTION 2 1 
PROTECTION.I6 2 1 
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If the file is not present in the disk directory» the orogram is 
notified by inserting a one in the RSeREINSTATE.NSG.PTR. In 


either case» 


controt is returned to the program through the 


normal processor gquaue mechanisn. 


FINDZMOGOQIFY {042 


CT.~OBJECT 
CT.ADVERB 


CT.2 
CT.3 
CT .4 
CT.5 
CT.6 


Refer to P.S. 


SIGRE 


CT»VERB 
CT.QBJECT 


CT.ADVERS 


15 
INVOKE NUMBER & PATH NUMBER OF THE PATH-NAME 
BIT 
0 RETURN LIST HEADS CREORG ONLY) 


1 RETURN LOGICAL ADDRESS CREOQRG ONLY) 
2 DM.STATUS FORMAT 
Q=BINART 


1=4-810T DECTMAL 


3 ON EXCEPTION 
4 = 
3 MODIFY 
6710 SELECTION EXPRESSION 
Q NEXT 
i PRIOR 
2 FIRST 
3 LAST 
4 NEXT AT 
3 CURRENT 
6 AT 
il DATA SET SELECTION EXPRESSION 


DN»~STATUS REGISTER BIT LENGTH 

DM»~STATUS REGISTER BASE RELATIVE 817 ADDRESS 

DATASET RECORD WORK AREA BIT LENGTH 

DATASET RECORD WORK AREA BASE RELATIVE BIT ADDRESS 

SEARCH KEY CCAT OF COMPONENT NAMES) BASE RELATIVE B17 ADR. 
INVOKE NUMBER & PATH NUMBER OF DATASET “NAME 


2212 5470. 


(DM? 


i6 
INVOKE NUMBER & PATH NUMBER 
CSUBSET IF INSERT) 


BIT 
0 INSERT 
i —_ 
2 DOMe»STATUS FORMAT 
O=BINARY. 
1=4-8TT DECIMAL 
3 ON EXCEPTION 
4 BEGIN TRANSACTION CNOT INSERT) 
3 INCLUDES ».LIST.»HEADS CREORG ONLY) 
6 END TRANSACTION CNOT INSERT) 
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rT NO AUDIT (BEGIN OR END TRANSACTION ONLY) 
3 SYNC CEND TRANSACTION ONLY) 
gy - 
10 STORE INDEXES ONLY CREOGRG ONLY) 
1a PSEUDO CREATE CREORG ONLY) 
CT.1 DMeSTATUS REGISTER B1T LENGTH 
CT.2 DM.STATUS REGISTER 3ASE RELATIVE BIT ADDRESS 
cT.3 DATASET RECORD WORK AREA BIT LENGTH CNOT INSERT) 
INVOKE NUMBER & PATH NUMBER OF DATASET CINSERT) 
CT .4 DATASET RECORD WORK AREA BASE RELATIVE BIT ADDRESS 


(NOT INSERT) 


Refer to P.S. 22i2e 5S4706 


QELETE (OM) 


CT.VERB 47 

CTwO8JECT INVOKE NUMBER & PATH NUMBER 
(SUBSET IF REMOVE) 

CT~ADVERS BIT 


0 REMOVE 
i = 
2 DM.»STATUS FORMAT 
D=BINARY 
1=4°BIT DECIMAL 
3 ON ExcePrion 
4"-li = 
CT.l DM.~STATUS REGISTER BIT LENGTH 
CT.2 DM»STATUS REGISTER BASE RELATIVE BIT ADDRESS 
CT.3 DATASET RECORD WORK AREA BIT LENGTH CNOT REMOVE) 
INVOKE NUMBER & PATH NUNBER OF DATASET CREMOVE) 
CT.4 DATASET RECORD WORK AREA BASE RELATIVE SIT ADDRESS 


CNGT INSERT) 


Refer to P.S- 2212 5470. 


CREATEZRECREATE (0M) 


CT.VERG 18 
CT.UBJECT INVOKE NUMBER & PATH NUMBER 
CT.ADVERS Bit 


Q - 

1 RECREATE 

2 DM.STATUS FORMAT 
O=BINARY 
i=4-81T DECIMAL 

3 ON EXCEPTION 

4-11 = 

CT.t DM.~STATUS REGISTER B1T LENGTH 


CT.2 DMeSTATUS REGISTER BASE RELATIVE BIT ADDRESS 
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cT.3 DATASET RECORD WORK AREA BIT LENGTH 
CT.4 DATASET RECORD WORK AREA BASE RELATIVE BIT ACDRESS 


Refer to P.5e 2212 5475. 


SHITCHsTAPE»DIRECTION 


CTAVERB 19 
CT.OBJECT FILE NUMBER 
CYT.ADVEAS BIT 
O-F NOT USED 
8-11 0 = READ FORWARD 
= READ REWERSE 
4 = WRITE 
REINSTATEMSGePTR WALUES 
0 GOOO SWITCH 
1 FILE SOT OPEN 
2 WRONG DIRECTION OR NOT A TAPE FILE 
3 END OF FILE 


This operator was added to facilitate the implementation cf the 
Tape Sort feature. It has found use in other apptications since 
that time. Essentiadiy» ait meraty changes the direction of a 
tape file without time-consuming Close and Open invocation. 


There is no way that this communicate can cause discontinuation 
of a program. Adi errors are merety reported to the progran. 
The file may be changed from input to output» provided it is not 
being read in the reverse direction. Direction way be charged or 
the same communicate which changes the I/3 mode» In other words» 
a file may be changed from inout and reverse to outpiet and 
forward with one communicate. 


Buffers are fildied by the NCP as a function of this communicate. 
No fieids in the FI8 are changads» however. Consequently» use of 
this communicate is not practical on blocked files. 


This communicate will not function if one of the file"s buffers 
has already encountered the physical end of the file. 


TERMZNATE CS TOP BUND 
CT.VERB 20 


This Communicate calis the Terminate Procedure directly. Tha 
Terminate Procedure is also called when a program is being 
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discontinued. There is very littde differance between a normal 
terminate procedure, where the routine is cadied via a 
Communicate and an abnormal one» where the procedure is cadlad by 
the MCP to discontinue a program. 


Programs may not be terminated if they are using a reader-sorter 
and the device is operating. In this cases the terminate 
rountine will wait until the flow is stopped on the sorter and 
then proceed with the termination. This is due to the fact that 
High~Priority Interrupts from the sorter can only be handled in 
code written exclusively for that purpose. At any rater att of 
this will be transparent to the user and the program witli be 
terminated» though not necessarily at the time tha Terminate 
Procedure is first invoked. 


& similar situation exists if the program has Data Management 
operations in process-» 1/0 Compiete on such an operation can 
only be handled by Osta Management code» and the Terminate 
Procedure wilt be forced to wait for comptetion of any such 
operations. 


The Terminate Procedure may also have to wait for Rottcin and 
Ro@ii-Out operations to be compteted. The progras must be present 
in memory before it can be terminated. 


As mentioned previous ys ali of the conditians listed to this 
point are transparent to the user. The Terminate Procedure has 
its own mechanisrs for waiting for such evants to be compiete. 
No action is required on the part of the user. 


The queue of keyboard messages antered via the Accept response 
widl be purged of any messages intended for this program at this 
point. Refer to the Software Qperationalt Guide explanation of 
the "AX" message for details on this queue. 


At this point» the Terminate Procedure wilt wait for any code or 


data overtays which way be in process to go to completion. The 
Terminate Procedure» if it must wait for such an events» yietds 
controt to the outer doop of the MCP. The Procedure wilt be 


continued when the [/0 goes to compietion. 


Any 1/0 operation which was initiated by the program and which 
did not use the normat Fide I/G0 mechanism witi be haited and 
delinked from the channel chain at this point. Exampdes of such 
operations are disk [70 initiated by the Disk Initialization 
utilities and ait Data Communications 1/0 operations. Tesporary 
disk storage obtained by the MCP to execute the prograwe is 
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returned to the disk availabie tabie. 


The Terminate Procedure next proceeds to close ail the files 
which are associated with the orogram and «hich are not yet 
closed. <A file which is closed by a user with no bits set in the 
Close Adverb or with the NO REWIND bit set in the adverb is not 
considered ciosed by the NCP. The unite in these cases» remains 
assigned to the programs even though there can be no I/0 in 
process for the file. The unit must be returned to the list of 
available resources when the program terminates. Files are 
always Closed with Release by the Terminate Procedure» except 
when the file is assigned to disk and FPB.LOCK is set. 


The Terminate Procedure next performs those functions associated 
with memory assigned to the program. The code segment dictionary 
user count is decremented. If it becomes zerore memory occurpies 
by the code segments and the segment dictionary is returned to 
the avaidable memory fist. Simidarty» the user count fer tha 
Interpreter used by the program is decremented. If it becomes 
zero» memory occupied by the interpreter and its segments is aiso 
returned. If the interpreter was partially or totality resident 
in M-Memorys» it is ramovede This may resuit in a change in thea 
mode of M-Memory management. If so» at is performed at this 
point. 


Simiitar functions are perforaed on any [Intrinsic Code the prograa 
may have been using. The user count for the Intrinsic Fite and 
for the Code file itsatf are decramented and stored in the disk 
file header in the disk directory. 


If the Log option is set» the Log is updated at this point. In 
addition to the type of terminations a count of code overlays» a 
count of data overtays»s the current time and date and the amount 
of processor time used by the program are stored in the Log. 


The program's overiay descriptor is removed from the disk chain» 
a SPO message is printed if the ENDJ option is sete and if this 
program was executed by another using the PROGRAN.CALL 
communicates», the catting program is marked ready to run. Memory 
occupied by the program’s run structure is returned to the 
availabie pool. The number of jobs running is decremented. A 
bit is set which wilt cause the next execution of the OQUTER.~LOOP 
to check the active job schedule. 


If any programs are in the Waiting schedule and are waiting for 
the successful termination of this programs they are moved to the 
Active schedule» provided this is a normal termination. If this 
program was a “Compile and Go" or a "Compile and Save™» the code 
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file generated is placed in the active schedule. 


FREE (OM) 


CT.VERB 21 
CT»~QBJECT INVOKE NUMBER & PATH NUMBER 
CT.ADVERS BIT 


0-14 = 
2 OM.~STATUS FORMAT 
O=BINARY 
1=4-BIT DECIMAL 
3 ON EXCEPTION 
4-11 = 
CT ol DMeSTATUS REGISTER BIT LENGTH 
CT.2 DM»STATUS REGISTER BASE RELATIVE BIT ADDRESS 


Refer to P.eS5e 22127 S470. 


TIMEZDATEZOAY 


CT.VERB 22 
CTeOBJECT BASE RELATIVE BIT ADDRESS OF WHERE TO PUT THE RESULT 
CT.ADVERB BIT 
0 1=DATE REQUESTED 
1-2 FORMAT | 
O YY/DDD (JULIAN) 
1 MM/DD/YY 
2 YY/MM/DO 
3 OD/MM/ YY 
3-4 REPRESENTATION 
0 BINARY 
1 4°BIT DECIMAL 
2 a-81T DECIMAL 
5 A=TIME REQUESTED 
6-7 FORMAT 
0 COUNTER 
1 HH2NM25S0S €24-HOUR CLOCK) 
2 HHIMM2SS.S TT (12-HOUR CLOCK» TT=AN/ FN) 
8-9 REPRESENTATION 
0 BINARY 
1 4“S81T DECIMAL 
2 8-BIT DECIMAL 
10 L=TODAYS.NAME REQUESTED 
11 - 
NOTE = TODAYS.NAME RETURNS 9 CHARACTERS LEFT JUSTIFIED 


FORMAT BINARY &-B1T DECIMAL 8-81T DECIMAL 
YY/CDO CJULIAN) 749=16 84+12=20 16424=40 | 
MM/DOSYY 44547=16 34848=24 164+16416=48 
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YY/¥M/0D 7+445=16 84+84+8=2% 16#16¢16=48 
DD/MMS YY 544+7=15 — «8484224 16416+16=48 
COUNTER 290 24 48 
HH3MM25S.5 5#64+644=2 1 8+8+64+4=28 16+16¢16+8=56 
HHSMMES54.5 TT 44#64644415=36 8484+644415=44 164164+1648+16=72 
TODAYS .NAME 72 (9 CHAR» LEFT JUST.) 


ANTTLALIZER 129 


CT»¥ERB 23 
CT.OBJECT BASE RELATIVE ADORESS OF 

6 BYTE UNIT MNENONTIC 

OR 

1/0 OESCRIPTOR 
CT.ADVERS VALUE 


0 ASSIGN UNIT TQ THIS PROGRAM 

i RELEASE UNIT 

2 INVALID 

3 LINK IN THE 1/0 OESCRIPTOR ANC INITIATE 
4 INVALID 


REINSTATE.MSGPTR VALUES 

if CY.~ADVERB=0 THEN 

PORT» CHANNEL AND UNIT OF DEVICE REQUESTED 
PORT BIT (3) 
CHANNEL BIT (4) 
FILLER BIT €1) 
UNIT BIT 4) 

ALL OTHER CASES 
0 GOOD COMMUNICATE 
i DISPATCH TO INVALID PORT OR CHANNEL 


This communicate is intended for intpiant use only. Anyone 
outside of Santa Barbsra Plant who attempts to use this 
communicate does so at his own risk. The communicate forsat and 
function may be changed from time to time. No notice of such 
change wild be supplied to any user prior to the change. such 
information will be available on request. 


Released MCP*s wild not attow a Write descriptor to be initiated 
on system disk. Attempting to do so will result in the programs 
being O5-ad. 


The MCP does not assure that the A and 8 addresses in the [7/73 
Descriptor are bounded by the program's Base/Liait registers. It 
is the programmer's responsibility to do this. Failure to do so 
wild result in unidentifiable system haits. 


To use this communicate» the programmer should first issue it 
with CT.ADVERB set to zero and CT.Q8JECT pointing to a 
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six-character unit mnemonic. If the requested unit is not 
available for any reason» the cadling program will be O5-ed. If 


the unit is avaitabdle> it wiil be assigned to the cadtling 
program. It is possibile to read any unit without requestirg that 
the unit be assigned to youe 


After the unit is assigned to the program» the communicate may de 
issued with CT.ADVERB set to two or three. The MCP copies the 
1/0 Descriptor outside the basetimit before it Links irto the 
chain. When the I/0 conpletes» the I[0.-ACTUAL.W~END and I0-RESULT 
are moved back into the base~Limit area. When the I/0 operation 
is completed» the [70 descriptor is removed from the associated 
channet chain. In order to again execute the [/05+ the program 
must issue another communicate with CT.ADVERB set to two or 
three. 


The program should issue the communicate with CT.ADVERB set ta 
one before it goes to end-of-job. 


it should be emphasized that this communicate was added to the 
MCP for purposes of onwtine pack initialization only and is 
intended for use only by that programe in the form supplied by 
Santa 3arbara Piant. Requests for maintenance or support froa 
any other source will be ignored. 


HAUT CSNOQ0ZEQ 


CT.~VERS 24 
CT.OBJECT LENGTH OF TIME IN 19THS GF A SECOND 
FUNCTION PROGRAM IS PUT TO SLEEP FOR SPECIFIED LENGTH OF TIME 


zie 


CT«VERB 25 
CT.OBJECT = 
CT»ADVERS * 
CT. MESSAGE AREA 3IT LENGTH 
CT.2 MESSAGE AREA BASE RELATIVE BIT ADDRESS 
REINSTATE.MSG.PTR VALUES 
9 NO ERRORS IN ZIP TEXT 
A ZIPPED INVALTO CONTROL CARD 


This communicate provides a means for programs to pass contro 


cards and keyboard messages to the MCP. There are no 
restrictions on the messages which may be passed. No messages 
are returned to the program by this procedure; the anty 


information returned is an indication of whether or not the 
syntax of the control instruction was valid. 
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Any program placed in the schedule as a resutt of a control 
message received from a ZIP Communicate will execute 
asynchronously with and independently of the program which 
executed the ZIP» unless programmatic means for synchronizing the 
two programs are provided in the programs. 


If the controt instructions passed via the ZIP communicate are 
invalid» a message is printed on the SPO to inform the system 
operator of ths occurrence. This is necessary», since invalid 
controi instructions can rasult in incorrect operational 
behavior » 


Acceer 


CT.~VERS 26 
CT.Q8JECT - 
CT»ADVERSB Bit 


0 RETURN IF NO MESSAGE 
imit = 
CT al MESSAGE AREA BIT LENGTH 
CT.2 MESSAGE AREA BASE RELATIVE BIT ADDRESS 


REINSTATE.MSGePTR VALUES 
0 MESSAGE OF LENGTH ZERO 
aFFFFFFa NO MESSAGE PRESENT 
ANY OTHER ¥WALUE LENGTH OF MESSAGE IN BITS 


This communicate was provided as a means of implementing the 
COBOL ACCEPT verb.pj Its use is not restricted to programs written 
in a particuiar tanguages it may be used by any prograg. 


The receiving field must tie within the bounds of the program's 


run structure. The program wilt be forced to wait for an 
operator response if bit one in the adverb is a zero and if there 
is no message in the Accept Gueue for the program. Controi 75 


returned to the program through the normat processor queues when 
a response from the operator is received. 


Messages are moved to the receiving field teft-justified withk 
blank fili. 


QiSPLAY 


CT.VERB 27 

CT.Q8JECT = 

CT.ADVERB = BIT 
o-10 = 
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ii D=CRUNCH BLANKS OUT OF MESSAGE 

1=PRINT MESSAGE AS I5 
CT ol MESSAGE AREA BIT LENGTH 
CT.2 MESSAGE AREA BASE RELATIVE BIT ADDRESS 


This communicate was provided as a means of implementing the 
COBOL DISPLAY verb. Like ACCEPT» it may be used by any program. 
It serves merely to print the wessage described by CY.1 and CT.2 
on the SPQ. 


If bit eleven in the adverb is sets» the MCP will reformat the 
entire message such that nonw-blank fields in the massage are 
separated by no more than ane i o—abiank. This as merety a 
convenience for the user programmer xshich may be used when the 
spacing of the words in the message upon the SPO is not 
important. 


USECRE TURN 
CT.VERB 28 


This communicate is not implemented. If receiveds it is igqnored 
and controd is returned to the user. 


208T HANDLER 


CT.¥VERB 29 
CTOBJECT BASE RELATIVE ADDRESS OF SORT INFORMATION YTAELE 
CT.ADVERB BIT (12) 

1 - SORTARESTART 

2@~- SORT.DUPCHECK 

3 = SORT~W1.PIOD 

4 ~ SORT~W2.PID 

9@"12 FILLER 


CT.i BASE RELATIVE BIT ADDRESS OF SORT KEY TABLE 
CT.2 INPUT FILE.NUMBER OR ADDR OF MERGE.INPUT.TABLE IF MERGE 
cT.3 OUTPUT FILE~NUMBER 
TT 4 TRANSLATE FILE .NUMBER OR NOT 9 
CT.6 DATA.ADDRESS CDELETE.KEY»TABLE) 
CT.? IF CSORT~W1ePID s= W1.PIQ.FLAG) THEN 
DATAeADDRESS CW1.PID0) ELSE 9 
CT.3 IF CSORT.WW2.PID 2= W2.PIOFLAG) THEN 


DATAeADDRESS CW2.PID) ELSE 0 


This communicate provides a means for the user program to cai 
the Sort Intrinsic. For detaiis on the implementation» refer to 
the proper Sort or Merge Product Specification. 
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SOL IRAce 
CT.VERB 30 


CT.OBJECT TRACE FLAGS 


This communicate is used by adt interpreters which include Trace 
capabilities. Its use is not restricted to SOL onty. The 
communicate is merely a means of turning the Trace on and off. 
The print tine is passed via a type 61 interrupt from the 
interpreter. The code invoked by this interrupt is Little more 
than a cadl4t on the SOL Read/Write Procedure in the “CP. 


EMULATOR TAPE CMICRO NOPD 


CT~VERB 31 
CT.O8JECT FILE NUMBER 
CT~ADVERB BiT 

O-2 OP.CODE 


0 = READ 

1 = WRITE 
2 = SPACE 
3 = REWIND 
& = TEST 


378 OP.COQDE .VARLTANT 
3 = REVERSE CREAD» SPACE)» ERASE CWRITED» 
TESTAWAITTREADY~NOT~REWIND CTEST) 
ONE»*RECORD CSPACE)» TAPE.MARK CWRITE D> 
TESTWAITSNOTAREADY CTEST) 
3 = DOD-PARITY CREAD» SPACE» WRITE) 
6 = NOTSE CREAD» SPACE) 
6 = NOT USED 
1 SCHEDULING» VARIANTS 
§ = FETCH.RESYLT 
10 = DONT.WAIT 
12 = REPORT AND RETURN ON TG ERROR 


3 
li 


CT.l USER TAPE BUFFER BIT LENGTH 
CT.2 USER TAPE BUFFER 3ASE RELATIVE ADDRESS 
CT.3 USER ERROR MASK CBIT SET IMPLIES USER WILL HANDLE THE 
CORRESPONDING ERROR) 
Bit 
0 CMAY NOT USE) 
1 CMAY NOT USED 
2 NQT READY 
3 PARITY C(NOT ON TEST) 
4 ACCESS CNOT ON TEST) 
s) TRANSNISSTON CON TEXT ONLY) 
6 ENO..OF .TAPE 
v BEGINNING.»GF TAPE 
8 WRITELOCK .OUT 
9 END-OF FILE (NOT ON TEST)» UNIT.PRESENT CORK 


TEST) 
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10 REWINDING 

il TIMEOUT CNOT ON TEST) 

1216 CMAY NOT USED 

17 SHORT.RECORD 

18 LONGe-RECORD 

19 DROPOUT 

20 INITIATE «LATE 

21 CMAY NOT USE) 

22 TRANSMISSTONERROR*MEC 

23 TRANSMISSION.ERROR MIC 
CT.4 BASE RELATIVE ADDRESS OF USER*S 48 BIT RESULT 


BIT 0°23 DF RESULT CONTAIN THE RESULT DESCRIPTOR 
Bil 24°47 OF RESULT CONTAIN THE ACTUAL LENGTH 
REINSTATE»MSGePTR VALUES 


0 = RESULT RETURNED 
1 = IQ.ERROR 
2 = RESULT NOT AVAILABLE 


This communicate was added $0 that the Esutators of 
second "generation hardware produced by Santa Barbara Plant might 
be operated under controt of tha MCP. It was necessary to add a 
new communicate to do thise since programs written for these 
machines routinety manipulate magnetic tape in manners which 
violate the rules of the MCP*s dogical I/0 mechanisms. The 
normal file mechanisms in the MCPe which were promuigated upon 
the specifications of the COB80L tanguage» are certainty 
inadequate to atilow ali of the many tape operations which were 
common to second generation machines. 


Essentiaily» the procedure builds an I/0 descriptor according to 
the specifications passed Sy the communicate format and initiates 
it. The Emulator prograsa is not allowed to execute untit the 1/6 
operation goes to completion. The procedure is fretentered at 
completion of the operation and the program is then atilowed to 
continue. 


The orocedure first tests to see if the file is Open. If it is 
note the Open procedure is catied directiy frow the communicate 
and control is returned to it when the open completes. At this 


point» the procedure contintes provided the open was successful. 
If it was not» the emulator program would have been placed in one 
of the processor queues and marked waiting. In the tatter case» 
the communicate procedure mereiy returns controt to the cuter 
loop of the MCP. 


The procedure next perforas minor editing on the files passed ir 
the communicate format. if the operator request involves a data 
transfer» the buffer area described must tie whoily within the 
bounds of the user's run structure. Due to herdware 
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restrictions» certain variants and combinations thereof ara 
invalid for certain operation codes. fhe variants here are those 
passed in bits three through seven of the communicate adverb. 
Validity of the variants is checked by the procedure. If the 
user has violated either the bounds check or the variant check» 
the program is automaticadly discontinued by the MCP. 


The procedure next constructs an I/0 Descriptor which corresponds 
to that requested by the user. fhe I/0 Descriptor is outside tha 
user*s run structure. A full tape file FIB is sllocateds» atong 
with space for one 1/0 descriptor» oy the Gpen Procedure. This 
is done aven though many of the fieids in it are not used by the 
Emulator Tape Handder routines directly. Most of the fields are 
required by the Close Procedure. 


The requested I/0 operation is then tnitiated and the program is 
marked waiting for its completion. Control is returned to the 
outer loop of the MEP at this point and the MCP is free to 
service other users. 


When the I/G operation completeass the procedure is again invoked. 
It first moves the result descriptor received with the 1/0 
concatenatad with a twenty~four bit field which wild specify the 
actuadl dength of the operation just completed. The tength of the 
operation is specified in bits. Also» pricr to doing the sove of 
the result descriptors» the procedure verifies that the receiving 
fieid is within the run structure of the program. If it is not» 
the program is automatically discontinued. 


If the exception bit is set in the result descriptor» the 
procedure determines if the exception condition is one that the 
user has inctuded code to handie himsetf. If it is» control is 
returned to the user through the normal processor queue 
mechanism. If the user does not have code to correct the error 
himself» the procedure calis the MCP*s [/0 Error procedure 
directly. 170 Error witt then retry a number of times and 
eventualiy return controd to the Emulator Tape Handler. If the 
error was irrecoverable» the program is discontinued. Otherwise> 
control is returned to tha user. 


COBOL EROGRAS ASNORMAL END 
CT~VERB 32 


This communicate was added so that job Streaming may be 
terminated at the discretion of the user. it functions exactly 
as the STOP communicate does excapt that instead of a standard 
End-of-Job message» it causes “COBOL ABNORMAL END” to be crinted 
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on the SPO. <Aisor any programs that are in the Waiting Schedule 
waiting for this job to finish will not be moved to the active 
schedude by the abnormal tarmination. 


aQRT £Os 
CT.VERB 33 


CT.OBJECT FILE »NUMBER 
CT»AADWVERB CLOSE TYPE 


CT at ENDWOF“FILE POINTER 
CT.2 RECORD SIZE 
This communicate serves to terminater in a normal manners the 


sort and Merge Intrinsics and to return control to the cattling 
program. For details on its operation» refer to the appropriate 
sort or Marge product specification. 


CREEZEZTHAW RUN STRUCTURE 


CY.~¥VERB 35 

CT.OBJSECT BIT QO CHIGH ORDER BIT) 
O=THAW 
L=FREEZE 


Depending upon the functions being perforred by a user programs 
it may not be permissable for the NCP toa change the memory 
location of the program's run structure or to roti it out ta 
di ske The most obvious exanple of this is the Disk 
Initialization Utilities. which have actuai 1/0 Descriptors 
within their run structure. There are severat other such casese 


The field in the Run Structure Nucleus» RS-TEMPORARYeFREEZE» 
gives motice to the MCP*s5 Rott Out procedures that this run 
structure may not be moved. This communicate provides a 
programmatic means of pumping and decrementing that fietd. 


COMPILE CARD INEQRMATION 


CT.VERB 36 

458 BITS SDL DESCRIPTOR CWHERE TO PUT INFO) IN FORMAT 5 
16 BITS=LENGTH 
24 BITS=ADDRESS 
RETURNS COMPILE CARD INFO IN FOLLOWING FORMAT 
#CHARS INFO 


os @e 8 epee ees ocenatannnvoe enna eananaeanevenanvnnwaneews see 88 O07 42S * 


30 OBJECT NAME 
02 EXECUTE TYPE 


19 PACK»NAME OF THE RUNNING PROGRAM 
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30 ETNTERPRETER NAME OF THE RUNNING PROGRAM 

10 INTRINSIC NAME CPACK & FAMILY) 

02 PRIORITY 

06 SESSION 

05 JO8 NUMBER 

20 1ST & 2ND NAMES OF RUNNING PROGRAM 

07 CHARGE NUMBER 

O01 FILLER 


36 BITS DATE COMPILED 
04 BITS FILLER 


10 USERCODE 

10 PASSWORD 

04 PARENT JO8 NUMBER 

20 PARENT QUEUE IDENTIFIER 
G1 LOG 3PQ 

04 SECONDS BEFORE DECAY 

01 PRIVILEGED 


This communicate returns selectad fields from the working copy of 
the Program Parameter Block to the user*s run structure. The 
receiving field dascribed by the SOL Descriptor must tie whottiy 
Within the run structure. The program will be automaticadity 
discontinued if it does not. The fields returned are presented 
in the fixed format shown in the tabie above. 


QYNAHIC MENDBY BASE 


CT»~VERB 37 . 
VALUE IS RETURNED IN COMMUNICATE MESSAGE POINTER AS 
SELF RELATIVE DESCRIPTOR 


This communicate returns the relative address of the dynamic» or 
overtayabile» area in the run structure. it is intended for use 
by programs written in SOL onty. 


HEMORY OUMP IO DIS6 


CTAVERB 38 
USED BY ALL LANGUAGES» INCLUDING SDL. 


This communicate causes the program*s run structure and other 
pertinent information to be dumped to disk and tocked in the 
directory with a unique name. The information may be processed» 
formatted and printed tater by a normal state program written for 
that purpose. , 


Programs which are aiready in the process of terminating may not 
be dumped. This is academic in this case» howevers since a 
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program which was terminating could not issue the communicate. 
Programs which are rotted out to disk widi be rotted back in and 
dumped» via an operator*s action» provided sufficient memory is 
available. Again» aif the progras were rotted out to disk» it 
could not possibly have issued the communicate. 


The amount of disk which wild be required to contain the dump 
fite usually exceeds by a considerable margin that required ta 
contain just the Base/Limit area of the program. in addition ta 
the run structures the dump fiie widti also contain the File 
Dictionaryr the FI8*s and buffers» the Data Dictionary and ati 
data segments» the code dictionary and the code segments whith 
are present in manory at the timer and other miscettaneous 
information. If sufficient disk is not availabier a message will 
be printed on the SPO and a one witit be returned to the program 
in RS»REINSTATE~MSGePTR.» The program wild be altowed to continue 
processing. 


The format of a dump file is as foliows? 


i. A "Pointer*™ records which is described below. 

ae The orogram*s run structure and Run Structure Nucteus. 

5 The Data Dictionary. 

4a Every data segment in the dictionary. Segments which ar2 
not in memory wiil be copied to the dump fite fron their 
docation on disk. 

5 The File Dictionary. 

6s Each FIB and its associated I/0 OBescriptors and buffers. 
This includes ali files that are open and those that are 
closed with no form of release. 

7. The working copy of the Program Parameter Biock, 

Bs The working copy of the initial scratchpad settings. 

i. The working copies of all File Parameter Blocks. 

10. If the program ts written in SOL» the LAYOUT.~TASLE. 

Control is returned to the program through the normat processor 


queue mechanism. Actually» the program is marked ready to run 
after the scratchpad is copied. 


The forsat of the "Pointer™ record is: 
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DUMPFILE.~NUMBER BiT{(24) 
TIME.OF DUMP BITC36) % Julian Date plus Time 
MNCP.DATE BIT{ io) XX MCP Version Date 
RELEASE.MCP BITC 4) 
LIMET~REGISTER BITC€24) 
DATAsDIC.»PTR BIT(24) 2% Retative Disk Address 
DATA.SEGS.»PTR BIT¢C24) * Relative Disk Address 
FI3201C+PTR BLI7(24) % Relative Disk Address 
FI8.PTR BIT¢(24) % Relative Disk Address 
PPB.PTR BiITC24) % Ratative Disk Address 
NET.~CONTROL»MACROD BITC4) % 1 if Data Communications Handier 


MCP. RELEASELEVEL BIT16) 


LAYOUT.~TABLE.PTR BITC24) 
LAYOUT.TABLE.SIZE B1TC24) 
DUMP «SYSTEM. 1D BIT(1I2) 


GET SES5TQN NUMBER 


CT~VWERB 39 
CT.OBJECT SESSION I5 PUT INTO RSAREINSTATE .MSG.PTR 


OC sINITTLATE210 
CT.»VERB 40 
24 BITS PORT 
24 BITS . CHANNEL 


24 BITS BASE RELATIVE ADDRESS OF [7/0 DESCRIPTOR 


This cosmunicate oprovides the capability of initiatirg I[/9 
descriptors on the data communications equipment which may be 
attached to a system. The {£/0 descriptor itself if constructed 
by the program» which is usually the Data Communications Kandter 
program generated dy the NOL Compiler. This is not a 
requirements however» and no test for this condition is wade by 
the code in the MCP. The communicate operator may be used by any 
program whose source Language contains the proper syntaxe 


The program will be automaticaily discontinued by thea MCP if the 
requested I/O controt is not a data communications control or if 
the control is already in use by another program. Also» if tha 
address of the I/0 descriptor does not lie within the program's 
run structure or aif the program attempts to initiate an [70 
descriptor with the "high priority interrupt request” bit set» 
the program wild be automatically discontinued. 


After the editing described above has been performed» tha 
requested operation is initiated. Controi is returned to the 
user through the normat processor queue mechanism. The prograa 
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is not forced to wait for the comptetion of the operation 
initiated? control is returned immediately after the initiation. 


NOLZMACRO COMMUNICATES 


CT~VERB 41 

CYTQBJECT INDICATES FUNCTION 

DESC1 BIT 1°48 MESSAGE AREA i 
DESC2 BIT 49-96 MESSAGE AREA 2 


QUEUVE.PTR BIT 977106 REMOTE FILE NUMBER OR STATION NUMBER 


QEWRire 
CT»OBJECT 24 
DESC1 RESULT AREA 
DE Sc2 DC-WRITE MESSAGE 
NOTE? NUMBER AT SUBSTRC(DESC2652) IS MESSAGE TYPE 


40=FINISH OPEN 

&L=NDL/MACRO PRESENT 

42-=ATTACH STATIONS TO REMOTE FILE 
43=DETACH STATIONS FROM REMOTE FILE 


QUICK QUEUE WRITE CREMOTE FILES2 
CT.08JECT 12 


DESCi MESSAGE HEADER 
DESC2 MESSAGE 
RMT.FL REMOTE FILE TO WHICH THE MESSAGE IS DESTINED 


QUICK QUEUE WRITE CSTATION NUMBER? 
CT.QBJECT 13 


DESCi MESSAGE HEADER 
DESC2 MESSAGE 
STWR STATION NUMBER 


ACCESS USERCODE FILE 


CT.VERB 42 
DESC BIT O-47 DESCRIPTOR TO PARAMETER LIST. 
PARAMETER LIST LAYOUT 
MODE BIT (€&) 
0 SET ALL PARAMETERS IN LIST EXCEPT USERCODE AND 


PASSWORD. THESE MUST BE SUPPLIED TG FIND 
CORRECT ENTRY. 

1 SET ALL PARAMETERS IN LIST EXCEPT INDEX. INDEX 
MUST BE SUPPLIED TO FIND ENTRY. 

2 SET QVERRIDE. USERCODE AND PASSWORD MUST BE 
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PRESENT FO FIND ENTRY. 

SET OVERRIDE. INDEX MUST BE SUPPLIED TO FIND ENTRY. 

ADD ENTRY. ALL FIELDS HAVE TO BE SUPPLIED. 

DELETE ENTRY. USERCODE AND PASSWORD MUST BE 
SUPPLIED TO FIND ENTRY. 

INITIALIZE ALL OVERRIDE BITS. 

CHANGE BY USERCODE. ALL ENTRIES FOR A GIVEN USER- 
CODE CAN BE CHANGED WITH ONE COMMUNICATE. USER@ 
CODE MUST BE PRESENT.» PACK FIELD MUST NOT BE 
EQUAL TO ZERO TO CHANGE IT.» CHARGE NUMBER MUST 
NOT BE EQUAL TO ZERD TO CHANGE IT. PRIORITY MUST 
NOT BE EQUAL TG ZERO TQ CHANGE IT. 

8 DELETE ALL RECOROS FOR A GIVEN USERCODE. USER- 
CODE MUST BE PRESENT. 
9 SET ALL PARAMETERS IN LIST EXCEPT USERCODE AND 
PASSWORD. ONLY USERCOOE HAS TO EE SUPPLIED 
BECAUSE SEARCH STOPS ON FIRST ENCOUNTER OF 
| GIVEN USERCODE. 

19 CHANGE BY INDEX. INDEX MUST BE PRESENT. 

PRIORITY CAN BE CHANGED BY SETTING FIELD TO NON 
ZERO CHARGE CAN BE CHANGED BY SETTING CHARGE 
FIELD TO NON*ZERG. PASSWORD CAN BE CHANGED BY 
SETTING PASSWORD TO NON-ZERO. 


“a OF 


il CLEAR PACK OVERRIDE FIELD FOR ALL GCCURRENCES OF 
THIS USERCODE. USERCODE MUST BE SUPPLIED. 
i2 CLEAR PACK OVERRIDE BIT FOR ALL OCCURRENCES OF 


THIS USERCODE. INDEX MUST BE SUPPLIED. 


INDE X BIT (10) 
USERCODE CHARACTER (109) 
WHEN SET BY PROGRAM (MODE = Ge 22 4» Se» 7e 8 Fo 11) 
THE USERCGDE MAY OR MAY NOT CONTAIN PARENTHESES. 
IF PARENS ARE NOT FOUND» ONLY THE FIRST EIGHT 
WHEN SET BY MCP CMODE = 1) 
USERCODE WEILL ALWAYS CONTAIN PARENTHESES. 
PASSWORD CHARACTER (19) 
PACK NAME CHARACTER (19) 
CHARGE # BT {24) 
PRIORITY BIT (4) 
PRIVILGD BIT €1) 
BVERRIDE BIT €1) 
REINSTATE*MNSG.PTR VALUES 
0 NO ERRORS. 
1 ERROR ON INPUT: EITHER INDEX [5 WROAG OR 
USERTOBDE/PASSWORD I3 NOT PRESENT. 
2 “"CSYSTEMI/USERC IDE" FILE NOT IN "US" SLOT. 


PROGRAM CALLER 


CT~¥ERB 4% 
438 BITS SDL DESCRIPTOR 
24 BIT LENGTH OF TEXT 
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24 31T BASE RELATIVE ADDRESS OF TEXT 


This communicate functions in a manner similar to the ZIP 
communicate described previousdy» with one notable exception. 
The program which issues this communicate is suspended» and 
removed from memory» untiit the program which is initiated by the 
communicate goes to end-ofejob. This communicates then» provides 
a means for one program to catl another and wait for its 
completion. The text which is addressed by the forty~eight bits 
passed with the communicate should be valid MCP Control Card 
syntax which causes the execution of a program. 


Unfortunateid ye no means are provided for passing parameters 
between the two programs involved. This cam be done onty via the 
Fite mechanism of the NCP. The FILE Controt Card» described in 
the Software Operational Guide» does provide some assistance in 
this area» 


The text passed by the communicate must tie within the program's 
run structures. The program will be automatically discontirued it 
it does not. No further editing is performed by the commuricate. 
The program which issued the communicate is not informed of the 
validity of the control syntax passed. 


LOADsDUME MESSAGE 


CTAVERB 46 
CT.OBJECT BASE RELATIVE ADDRESS OF MESSAGE 
CT~ADVERB BIT 

0 =LOADED G=DUMPED 

isa. 


This communicate causes the thirty bytes beginning at the address 
specified by CT.Q83JECT concatenated with either the word "LOADED” 
or the word "“OUMPED"» depending upon the setting of bit i of the 
adverb» to be displayed upon the SPO if and onty if the itd 
system option i383 set. Refer to the Software Operational Guide 
for details on the LIB option. All nonw-blank EBCDIC fietds in 
the message widl be shifted to the left before printing untit 
they are separated by no more than one EBCDIC biank. 


COMPLEX WAIT CHICRO MCPD 


CT.VERS 47 
CT.OBJECT NUMBER OF EVENTS 
CTADVERG FIRST EWENT TG CHECK CCHECKED IN CIRCULAR 
FASHION FROM THIS POINT). 
CTAL“ETC. BIT ENCODED EVENTS CNUMBER SPECIFIED 8Y CT.Q8JECT 
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MAX=15). 


O- 3 EWENT TYPE 
4~ 7 EVENT PARAML 
8-15 EVENT P ARAN? 
16°24 EVENT PARAMS 
EVENT TYPES: 
0 - NULL = PARAMI»2293 3 NOT USED 
1 = SPO INPUT PRESENT = PARAMi»2e35 2 NOT USED 
2 ~- TIME ~ PARAMie2»3 = CONCATENATED BIT 20 
FIELD CONTAINING THE LENGTH OF TIME 79 
WAIT IN 1OTHS OF A SECOND 
3 = READ OK ~PARAM1: NOT USED» PARAM2: 
FILE NUMBER» PARAMS? WENSER NUMBER IF FILE IS 
G@*FILE“FAMILY 
4 ~ WRITE OK =~ PARAMi»2»3s SAME AS READ OX 
3 = QUEVE WRITE OCCURRED - PARAMN1: NOT USED» 
PARAMN2: FILE NUMBER OF Q-FILE*FAMILY>» 
PARAMS: NOT USED 
6 = DATA COMM I0 COMPLETE = PARAML»2,532 NOT USED 
REINSTATE*MSGePTR VALUES 
ZERO RELATIVE INDEX TO THE COMMUNICATE EVENT LIST ELEMENT 
WHICH I5 COMPLETE 


MESSAGE COUNT 


CT.VERG 48 
CT.0BJECT FILE .NUMBER 
CTADVERSB 0 DECIMAL FORMAT RESULTS IF TRUE 
COBGL C"PIC 999") 
ELSE BINARY CBIT €24)) 
i-iit = 

CTei RESULT FIELD LENGTH 
CT.2 BASE RELATIVE RESULT FIELD ADDRESS 


FUNCTION RETURN THE COUNT OF THE MESSAGES CONTAINED 
IN THE QUEVE"FILE SPECIFIED. IF THE OBJECT 
IS A QUEUVE“FILE“FAMILY» THE COUNT WILL BE 
RETURNED AS A LEFT=JUSTIFIED ARRAY OF 
24°-31T COUNTS» ONE FOR EACH MEMBER OF 
THE FAMILY. 


RECOVERY COMPLETE 
CT.VERB 50 


Refer to P.»Se 2212 5479. 
GET*ATIRIBUIES 


CT.VERB 51 
CT.OBJECT FILE NUMBER 


?~db 
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CT.ADVERS COMMUNICATE LEWEL (MK 7.20 LEVEL=1) 

CT.1 TOTAL ATTRIBUTES CMUST BE 1 IN 7.0) 

CT.2 BASE RELATIVE ADDRESS OF ATTRIBUTE LIST 

CHANGE SATTRIBUTES 
CTVERB 52 


CT.OBJEXT FILE NUMBER 
CT.ADVERB COMMUNICATE LEVEL (MK 7.20 LEVEL=1) 


CT.l TOTAL ATTRIBUTES CMUST BE 1 IN 7.0) 

CT.2 BASE RELATIVE ADDRESS OF ATTRIBUTE LIST 
ACLES 2 sGLOBALS 

CT.VERB 55 

CT.O8JECT 0 = CT.3 CONTAINS AN ABSOLUTE MEMORY ADDRESS 


i o= HINTS.» CT.~3 WILL BE USED AS AN OFFSET 
INTO TRE FIELD 
2 = RS»*NUCLEUS. USE OF CT.ADWERS AND CT.3 IS 
DESCRIBED BELOW 
3 = IDAT.~ USE OF CT.ADVERS AND CT.3 5 CES- 
CRISED BELOW 
& = DCH»ASCRATCU.MEM 
3 = PACK.INFO TABLE 
6 = SPG.52 
CT ~ADVERS SEE BELOW 
CT.ei and €f.2 A BASE*RELATIVE SOL DESCRIPTOR WHICH SPECIFIES 
THE RECEIVING FIELD IN THE PROGRAM. THE FIRST 
EIGHT BITS GF CT.~1 ARE IGNORED @8Y THE MCP 
CT.3 SEE BELOW 


Since HINTS actuaiiy begins at absolute Location zero» thera is 
no functional difference between reading an absotute memory 
location and reading HINTS with an offset. Both settings of 
CT.~OBJECT are addowed to accomodate possibite future expansion to 
the function of accessing HINTS. 


When reading Run Structure Nuclei» alt nuclei are returned if 
CT«ADVERB is set to zero. The number of nuctei that are 
currentty present in memory is returned as a setfrrelative value 
in RS.~REINSTATEMSG.PTR. <ALL of the nuclei will be copied to the 
receiving field in the program in the order that they are tinked 
in memory and up to the Limit contained in the size specification 
in CTele If the nuctei of all executing programs are transferred 
to the receiving field before it is exhausted» the remaining 
portion of the fieid witl be set to blanks. 


To access the Run Structure Nucleus of one particular executing 
programs CIs.AODVERB should be set to one and the jobd number of the 
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program shoudd be contained as a twanty"four bit binary vaiua in 
CT .3- If CY¥.3 contains zeror the nucteus of the requesting 
program wiitl be returned. If the nucteus of the program 


specified by CT.~3 is not in memory for any reasone the receiving 
field wilt be set to aFFFFFF2 jand fidted with blanks and a 
self-retlative vatue af one witi be returned in 
RSeREINSTATE.~MSG.PTR, 


When reading the [OAT» if CT.~ADVERB is set to zero» CTe3 wiil be 
used as an offset into the IOQAT and the remaining portion of the 
table widd be transferred» up to the dimit spacified in CT.1i. 
The . value of CT.3 may be zero» of courser and the entire table 
may be transferred. Lf CT.ADVERS is set to one» CY~3 wiit be 
assumed to contain the twenty*four bit binary value of a file 
number associated with a file which the program currently has 
opens Ali of the IDAT antries which foldow the associated entry 
may be transferred» depending upon the value contained in CT.1. 
If the fide is not open or is not praesent in memory for any 
reasons aFFFFFFS witt be transferred» the remainder of the 
receiving field witi be set to olanks and RS.~REINSTATE.~*SG.PTR 
widit be set to a selfrrelative value of one. 


If CT.ADVERS §85 set to a value of two when reading the IDATs the 
lowrmorder twelve bits of CT.3 witli be assumed to cortain a 
Port/Channet/Unit combination in the foltowing format: 


Bits 12 = 14 Port 
8its 15 - 18 Channed 
Bits 19 = 23 Unit 


The MCP will scan the [GAT for the entry associated with the 
specified unit and wilt return that entry pius adil subsequent 
entries up to the Limit of the IDAT or that specified in CT.i. 
If the specified unit is not present in the IQAT» the MCP will 
set the receiving field to @FFFFFFS followed by blanks and widt 
set RS»REINSTATEMSG.PTR to a selfwrelative value of one. 


ANQEXED SEQUENTIAL POSITION 


CT»VERB 56 
CT.O8JECT FILE NUNBER 
CT~ADVERB BIT 
0 = 
1 REPORT TQ USER ON PARITY 
2 - 
3 RESULT MASK FIELDS PRESENT 
4-5 ? 
6-7 RELATIONAL OPERATGR 


0 EQUAL TO 
i GREATER THAN 


7-68 
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2 NOT LES THAN (> @ =) 
8-10 SELECTION CONDITION 
0 NEXT 
i PRIOR 
2 FIRST 
3 LAST 
4 NEXT AT 
5 CURRENT 
i) AT 
? RANDOM 
11 = 
CT.1 LENGTH OF RESULT MASK 
CT.2 ADDRESS OF RESULT MASK 
cT.3 ~ 
CT.4 . 
CT.5 STRUCTURE NUMBER 
CT.6 KEY ADDRESS 
CT.? KEY LENGTH 
INDEXED SESUENTIAL READ 
CT.VERB of 
cT.OBJECT FILE NUNBER 
CTsADVERB BiT 
0 REPORT 79 USER ON EOF 
i REPORT TO USER ON PARITY 
2 - 
3 RESULT MASK FIELDS PRESENT 
4-5 is 
6-7 RELATIONAL OPERATOR 
Q EQUAL TO 
= | GREATER THAN 
2 NOT LESS THAN (> @ =} 
§$-10 SELECTION CONDITION 
i] NEXT 
i PRIOR 
2 FIRST 
3 LAST 
4 NEXT AT 
) CURRENT 
6 AT 
? RANDOM 
11 
CT.i LENGTH OF RESULT MASK 
CT.2 ADDRESS OF RESULT MASK 
CT.3 LOGICAL RECORD LENGTH 
CT .4 LOGICAL RECORD ADDRESS 
CT. STRUCTURE NUMBER 
CT.6 KEY ADDRESS 


CT.? 


BURROUGHS CORPORATION 


COMPUTER SYSTEMS GROUP 


SANTA BARBARA PLANT 


ANQEXED SEQUENTIAL WRITE 


CY.VERG 
CT.0B8JECT 
CT.~ADWERSB 


CTai 
CT.2 
CT.3 
CT.4 
CT.5 
CT.6 
CT.7 


58 

FILE NUMBER 

BIT 

0 REPORT TO USER ON EOF 

i REPORT TQ USER ON PARITY 

2 _ 

3 RESULT MASK FIELOS PRESENT 
4-i1i <= 


LENGTH OF RESULT MASK 
ADDRESS OF RESULT MASK 
LOGICAL RECORD LENGTH 
LOGICAL RECORD ADDRESS 
STRUCTURE NUMBER 

KEY ADDRESS 


ENDEXED SEQUENTIAL REWRITE 


CT.VERB 
CT~OB8JECT 
CT~ADVYERB 


CT. 
CT.2 
CT.3 
CT. 
cT.5 
CT.6 
Ci.’ 


39 

FILE NUMBER 

Bit 

9 - 

i REPORT TQ USER GN PARITY 

2 = 

3 RESULT MASK FIELDS PRESENT 
4"-1i = 


LENGTH OF RESULT MASK 
ADDRESS OF RESULT MASK 
LOGICAL RECORD LENGTH 
LOGICAL RECORD ADDRESS 
STRUCTURE NUMBER 

KEY ADDRESS 


INDEXED SEQUENTIAL DELEIE 


CT.»VERB 
CT.~OBJECT 
CT.ADVERB 


CTel 
CT.2 
CT.3 
CT.4 
CT.5 
CT.6 


60 

FILE NUMBER 

BIT 

0 - 

i REPORT 70 USER ON PARITY 

2 = 

3 RESULT MASK FIELDS PRESENT 
4-11 °- 


LENGTH OF RESULT MASK 
ADDRESS OF RESULT MASK 


STRUCTURE NUMBER 
KEY ADDRESS 
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CT.7 = 


RELATIVE 140 COMMUNICATE = SIRT 


CT.VERB 61 
CT.O8JECT FILE NUMBER 
CT~ADVERB BIT 
0 REPORT T0 USER ON EOF 
1 REPORT AND RETURN TO USER ON PARITY 
2 REPORT AND RETURN TO USER CINCOMPLETE I/0) 
3 RESULT MASK FIELD PRESENT 
4-5 - 
o-7 RELATIONAL OPERATOR 
0 EQUAL TG 
1 GREATER THAN 
rd NOT LESS THAN 
8-11 =~ 
CT el LOGICAL RECORD BIT LENGTH 
CT.2 LOGICAL RECORD BASE RELATIVE BIT ADDRESS 
CT.3 ACTUAL BINARY DISK KEY {RELATIVE KEY) 
SUPPLIED 3¥ USER 
CT.4 = 
CT.5 LENGTH IN BITS OF RESULT MASK FIELD 
CT.6 BASE RELATIVE ADDRESS OF RESULT MASK FIELD 
REINSTATEMSGePTR 
0 GOOD READ 
i END OF FILE 
2 1/0 ERROR 
3 INCOMPLETE I[/0 


CADDITIONAL ITEMS FOR FILE STATUS DEFINED IN THE SEQUENTIAL 
FILES DESIGN SPECIFICATION) 


RELATIVE 120 COMMUNICATE = WRITE 


CT.VERS 
CT»~QBJECT 
CT.ADVERB 


62 

FILE NUMBER 

BIT : 

Q REPORT 10 USER ON EQF 

1 REPORT AND RETURN TO USER ON PARITY 

id REPORT AND RETURN TQ USER CINCOMPLETE 170) 
3 RESULT MASK FIELD PRESENT 

4 ACCESS TYPE 


6 SEQUENTIAL CNEXT) 

1 RANDOM CAT KEY) 
s7ii 
LOGICAL RECORD BIT LENGTH 
LOGICAL RECORD BASE RELATIVE BIT ADDRESS 
ACTUAL BINARY OLSK KEY FOR RANOOM OR DYNAMIC 
FILES CSUPPLIED SY USER? NOTHING IF IN 
SEQUENTIAL MODE) 


LENGTH IN BITS OF RESULT MASK FIELD 


a ee | 


BURROUGHS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP 31000 MCP If 
SANTA BARBARA PLANT PeSe 2212 5462 (CE) 
CT 65 BASE RELATIVE ADDRESS OF RESULT MASK FIELD 
REINSTATE.MSG.PTR . 
9 GOOD READ 
1 ENO OF FILE 
2 1/0 ERRGR 
3 INCOMPLETE L790 


CADOITIONAL [TEMS FOR FILE STATUS DEFINED IN THE SEQUENTIAL 


FILES 


DESIGN SPECIFICATION) 


RELATIVE [70 COMMUNICATE = REWRITE 


CT.AVERS 63 
CT.OBJECT FILE NUMBER 
CT.ADVERS 3iT 
0 REPORT 72 USER ON EOF 
1 REPORT AND RETURN TO USER ON PARITY 
2 REPORT AND RETURN TO USER CINCOMPLETE 170) 
3 RESULT MASK FIELO PRESENT 
4 ACCESS TYPE 
9 SEQUENTIAL CNEXT) 
1 RANDGM CAT KEY) 
S11 - 
CTal LOGICAL RECORD BIT LENGTH 
CT.2 LOGICAL RECORD BASE RELATIVE SIT ADDRESS 
CT.3 ACTUAL BINARY DISK KEY FOR RANDOM OR DYNAMIC 
FILES (SUPPLIED BY USERS NOTHING IF IN 
SEQUENTIAL MODE) 
CT.4 - 
cr.5 LENGTH IN BITS OF RESULT MASK FIELD 
CT.6 BASE RELATIVE ADDRESS OF RESULT MASK FIELD 
REINSTATE.MSGePTR 
9 GOOD READ 
1 END OF FILE 
2 1/0 ERROR 
3 INCOMPLETE 1/706 


CADDITIGNAL ITEMS FOR FILE STATUS DEFINED IN THE SEQUENTIAL 
FILES DESIGN SPECIFICATION) 


THE REWRITE COMMUNICATE WILL BE ESSENTIALLY THE SANE AS 
THE WRITE» SUT WILL HAVE A DISTINCT MEANING IN LOGICAL I/30 


RELATIVE [20 COMMUNICATE = DELETE 


CT.VERG 
CT.O8JECT 
CT~ADVERB 


64 

FILE NUMBER 

BIT . 

Q REPORT 10 USER ON EOF 

1 REPORT AND RETURN TO USER ON PARITY 

2 REPORT AND RETURN TO USER CINCOMPLETE 170) 
3 RESULT MASK FIELD PRESENT 

4 ACCESS TYPE 


0 SEQUENTIAL CNEXT) 


ill 
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1 RANDOM CAT KEY) 
seit 6 

CT el ae 

cT.2 

CT.3 ACTUAL BINARY DISK KEY FOR RANDOM OR DYNAMEC 


FILES CSUPPLIEO BY USER? NOTHING IF IN 
SEQUENTIAL MODE) 


CT.4 
CT.5 LENGTH IN BITS OF RESULT MASK FIELD 
CT.6 BASE RELATIVE ADORESS OF RESULT MASK FIELD 
REINSTATE~MSGePTR 
0 GOOD READ 
1 END OF FILE 
2 1/0 ERROR 
3 INCOMPLETE i/70 


CADDITIONAL TITEMS FOR FILE STATUS DEFINED IN THE SEQUENTIAL 
FILES DESIGN SPECIFICATION) 


RELATIVE 170 COMMUNICATE = BEAD 


CT.VERB 65 
CT.OBJECT FILE NUMBER 
CTeADVERB BIT 
0 REPORT TO USER ON EOF 
i REPORT AND RETURN TO USER ON PARITY 
2 REPORT AND RETURN TO USER CINCOMPLETE 1790) 
3 RESULT MASK FIELD PRESENT 
4 ACCESS TYPE 
QO SEQUENTIAL CNEXT) 
1 RANDOM CAT KEY) 
5-11 - 
CTel LOGICAL RECORD BIT LENGTH 
ct.2 LOGICAL RECORD BASE RELATIVE BIT ADDRESS 
CT .3 ACTUAL BINARY DISK KEY FOR RANDOM OR OYNANIC 


FILES (SUPPLIED SY USERs NOTHING IF IN 
SEQUENTIAL MODE) 


CT.5 LENGTH IN BITS OF RESULT MASK FIELD 
CT.5 BASE RELATIVE ADDRESS OF RESULT MASK FIELD 
REINSTATE.MSGePTR 

i) GOOD READ 

1 END OF FILE 

2 T/0 ERROR 

3 INCOMPLETE i760 


CADDITIONAL ITEMS FOR FILE STATUS DEFINED IN THE SEQUENTIAL 
FILES DESIGN SPECIFICATION) 


SEQUENTIAL REWRITE CMMCPD 


CT VERB 66 
CT~O8JECT FILE NUMBER 
CT .ADVERB BIT 


boos ee 
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0 REPORT AND RETURN TO USER ON EOF 

1 REPORT AND RETURN TO USER ON PARITY ; 

2 REPORT AND RETURN TO USER ON INCOMPLETE [72 

3 LENGTH ADDRESS PART IS PRESENT FOR THE RESULT 

MASK 
4-11 * 


CT al 
CT.2 
CT.3 
CT 4 
CT.5 
CT .6 


LOGICAL RECORD BIT LENGTH 
LOGICAL RECORD BASE RELATIVE BIT ADORESS. 
RANGOM FILE ACTUAL BINARY KEY 


LENGTH IN BITS OF RESULT MASK 
BASE RELATIVE AGDRESS OF RESULT MASK FIELD 


INDEXED/SEQUENTIAL OPEN 


CT .VERB 
CT»OBJECT 
CT.ADVERB 


CT.1 


CT 2 
CT.3 


67 

FILE NUMBER 

B1T 

9 REPORT.FILE «MISSING 

i REPORT.FILE LOCKED 

2 REPORT»~EXCEPTION CSECURTTY ERRORS) 
3-11 


CTHE OPEN TYPE IS TAKEN FROM THE FPB.»ADVERB AND 
FPB»~EXPANDED»~ADVERS FIELDS) 

LENGTH OF USERCODE/PASSWORD FIELD 

CIF GPEN.ON.SEHALF .OF > 

BASE RELATIVE ADDRESS OF USERCOBE/PASSWORT FIELD 
OPEN STATUS = RESERVED FOR THE SMCP TO KEEP TRACK 
QF WHERE TQ RESUME IF THE ENTIRE OPEN CANNOT BE 
COMPLETED. 


om 
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INTER=PROCESS COMMUNICATION 


QUEUE SYSTEM AND INTERFACES 


A message queue system has axisted in MCP If since 1973. This 
section describes the current Queue impdiementation ard the 
interfaces between the Queue system and other system software. 


The word "Queue™ as used in this document» most often refers to 
the actual data structure maintained by the operating syste. 
This data structur@# is used as a means of inter-process 
communication. Queues may have various attributes just as fitias 
do» For example» Queues say have two tencharacter names» user 
countsSs message counts» and so forth. The data structure is used 
to address a list of messages. This dist may be empty. A Queue 
user may add to the back or remove from the front of this (list. 
The Queues may be shared =“ ane or more processes may put messages 
in the List and one or More processes may remove messages. Oniy 
the MCP may access the data structure directly. User programs 
Must use other mechanism#s» which are constructed from this data 
structures such as Queue Files or Remote Files. 


DESIGN PHILOSOPUY 


The design of the data structure (Figure 81) was strongly 
affected by the need to reduce the S=memory needs of cueues. 
Reusabie structures like message buffers and message descriptors 
are pooled for the use of the whote queue syste. The memory 
space used by empty message buffers and descriptors is not 
automatically returned to the system. The Queue implementations 
rather»s retains them for Later use. This resuits in cuicker 
adifocation when this space is required again and in tess 
disturbance of the working set of the code in the system. Since 
queue Files and Remote Files are unbtocked» their FIB8"*s need not 
have buffers. This minimizes the amount of memory required to 
contain the FIB. 


QUEUE CILE FAMILIES | 


A Queue File Family may consist of a maximum of 1023 Queuessr each 
having the same first name or MFID and the same attributes. A 
Queue Fide Family is shown diagrammaticadiily in Figura 8-2. A 
user program may READ a message from one of the individuat Queues 
in the fanily or it may request a message from any queue in the 
famidy. Gn a WRITE operation»e however» the individual family 
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member must be spacifiad. 


if individual Queues of a Queue File Family are to be addressed» 
the individual mamber must be specified by an ordinal numbers or 
keys much dike Switch Fides in certain languages. A key of zero 
specified on a Read of a Queue File Family means that the user 
wild accept a message from any of the individuat Queues which 
comprise the family. Vim selective rere. 


QUEUE DESCRIPTORS 


For a given Queue» the Queue name» maximum tength»s pointers to 
first and last messages» etc» are stored in the Queue Descriptor. 
The descriptor must be in mesory during the existence of the 
ueue. Users of the Queue are given “Q-keys"» which serve as 
pointers to the Queue Descriptor» when the Queue File is opened 
and the user has specified the desired attributes of the Queue. 
For a Queue Filer the Q~key is stored in the file's FI8. If the 
Queue is empty» the 360-bit descriptor is the only memory 
structure dedicated sodely to the @ueue. 


QUEVE Disk 


Messages stored in a queue may reside on disk or in memory. At 
Queue creationes an area of system disk is obtained for the Queue 
large enough to hold @eMAX.MESSAGES of size Q.MAX.~NESSAGE.SIZE. 
These two attributes are normally specified by the user. <A Queue 
specified to contain a maximum of 255 messages» each of a Raximum 
size of 200 bytes will require 255 #*€€2004179) DIV 1803 er 516 
disk segments» where DI¥ denotes an Integer Divide operation. 
The required disk space wilt be atiocated when the Queue is 
openeds prior to the time it is actuaily required. This is done 
to minimize the processing required to store the message or disk. 
Users who have minimal amounts of disk storage available may 
controt the amount that is required by Queues by manipulating 
Qe MAXeMESSAGES. The disk space that is adlocated to Queues is 
not Locked in the directory, If the system faiis white Quaues 
are activer the disk is returned to the availabte tist during the 
ensuing Clear/Start operation. Disk is always ailiocated toa 
Queues» even if sufficient memory is avajlable to contain the 
maxitum number of messages. 


Queue messages are written to disk when a message baing put into 
a queue makes the count of messages in memory equal to thea 
attribute @ BUFFERS. When this situation occurs» a disk Write 
operation on the tast message in memory in the Queue is 
initiated. This widt make one of the buffers availabte for an 
ensuing insertion in the Queue. There is one exception to this 
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Statement. The disk Write operation will not be initiated by the 
Queue routines if the attribute Q@.8UFFERS is equal to or greater 


than the attribute QeMAX»MESSAGES. In this case» messages 
associated with the Queue may only be written to disk by the 
Memory Management routines. The Memory Management routines may 


write Queue messages to disk anytime memory is required in the 
system. This ensures that Queue messages widi not fill memory to 
the point where thrashing occurs. 


When a user removes» or READS» a message from a Queue the first 
message in the Queue is transferred to his Run Structure ard the 
next message in the Queue is examined to determine if it is oan 
disk. If it is» a took-ahead disk Read operation is initiated to 
minimize the time that the user will have to wait for delivery of 
the next Queue message. 


The I/0 descriptors that are used for the disk Read and Write 
operations just described reside in the Queve Fidie"s FI. For 
each mode of use» input or output» a program opering a Queue File 
is given one I/0 descrigtor. A file opened input and output is 
given two I/0 descriptors. I70 descriptors are shared among ati 
members of a Queue File Family» so that no Queue Fite FIB witl 
ever contain more than two [/0 descriptors. 


MESSAGE CESCRIPTORS 


The method of storing messages in the queue is by means of a 
linked list of Message Descriptors.» tach Message Descriptor (MD) 
consists of an 80-bit system descriptor and two tink fields» for 
a totai of 128 bits each. The system descriptor actuaily 
describes the message text» according to normal NCP conventions. 


To reduce checkerboarding» MD*s are allocated in blocks of ten. 
Assigning a Message Descriptor to a message is accomplished by 


searching the biock(€s) of ten for an available MO. If none are 
available» memory space for an additionat biock of ten is 
obtained via acaii on the Memroy Management routines. The 


blocks of Message Descriptors are surveyed periodicaliy ta 
consotidate and return unused blocks to the system. At Least one 
block is retained as tong as any Queues exist. 


MESSAGE QUEFERS 


If a queued message is in mamory», the memory aresa which contains 
the message is known as a Message Buffer (M3). The ML.~TYPE field 
in the memory tink which describes the area will be set to a 
unique value which denotes a Message 8uffer. No Queue will ever 
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have more than @e8UFFERS messages in memory at any time» 
including those messages which are in transit between memory and 
disk. Actually» since the Memory Management routines are capabta 
of writing Queue messages to, disk and removing them from semory>s 
the Queue routines cannot guarantee that any messages will be in 
memory at any given time. 


QUEUE ATTRIBUTES 


In addition to attributes common to ati files» the user ~M*may 
specify two attributes whose interpretation has meaning for Queue 
Fites onty:s 


1. QeMAX»MESSAGES - the maximum number of massages a Queue can 
storere at which point it is considered full Cmaximusw 1023}. 


2 Q»FAMILY.~SIZE - the number of sub-qusues tn a Quete Fite 
Famity (maximum 1023). 


In additions &@.B8UFFERS as described in the foregoing may be 
specified by the BUFFERS file attribute. Thus» the user may have 
some controd over the number of massages that may ba contained in 
memory at any given time. In the COBOL Languages a Queve File 
Dectaration may appear as: 


SELECT M¥.@ ASSIGN TO QUEUE. 


Ld 


FDO MY.Q VALUE OF Q.MAX.MESSAGES [5 290 
RESERVE 3 ALTERNATE AREAS. 
O1 MY.a.BUF PIC X€80). 


SELECT MY..»QFF ASSIGN TO QUEUE. 
FO MYeQFF FILE CONTAINS 3 QUEUES 
VALUE OF Q.MAXeMESSAGES [5 10 

RESERVE 2 ALTERNATE AREAS. 
O1 MY.QFF.B8UF PIC X€80). 


If a Queue Fite Family is opened» the same attributes appty to 
every wme#ber individually. In MY¥.QFF above» for exampte>» ail 
three members may hold ten messagese each having a saximum of two 
In memory. 
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The name assigned to a Gueue File is specifed by the user as the 
MFID/FID combination. For a Queue File Family» the MFID is 
specified by the user and is taken to be the first ten 
characters» and an FID is synthesized from the sember nusber for 
each queue in the family. The first member of MY.QOFF would be 
named "MY.QFF/#00000001". 


When a Queue File is opened» the MCP compares the 20*chsracter 
name with the names of adil Queues currently in existence. If a 
Queue of that name if founds the opener is linked to the existing 
queue and the @Quesue"s user count is incremented. If the Queue 
does not exist» anew Queue is created with the attributes 
provided by the FPS. Queue attribute binding occurs when the 
Queue is first created» by the first process to open the fueve 
File. If two programs share a Queue {e.g.» both agree on the 
named» the first program to open the shared Queue file birds the 
attributes. 


Blocking of records is not adilowed in Queue Files. The Record 
Size attribute determines the upper Limit on the tength of a 
message which may be stored in a queue file. 


QUEVE ECILE LOGICAL 120 OPERATIONS 


Gueue File logical I70 operations are rather simple ana 
straightforward. AS mentioned previously» afi Queue Fites must 
be unblocked. Truncation or blank f144 may occurs dependirg upon 
the size of the user*s work area and the size af the sessage 
being movads exactty as is done on ati other togicat 1/73 
operations on 81000 systems. The user May request that three 
different exception conditions be reported to hin on ati Queue 
File togicai 1/0 operations. These three conditions arer in 
COBGL syntax: 


1. ON ENO-OF*FILE 
2. QN EXCEPTION» and 


3e ON INCOMPLETE-IG. 


On READ operations» END°OF*FILE is reported to the user when the 
Queue File is empty and no program exists which has the Queue 
opened for output. EXCEPTION is reported on Queue Fite Families 
only and on READ operations only» and actuality denotes an invalid 
key passed on the READ to specify the desired family sember. 
INCOMPLETE“I0 is reported if tha Queue is empty but programs 
stiidd exist which have the Queue opened for output purposes. Ail 
three conditions are reported onty if requested» of course. 
Faiiure to request that END-OFSFILE or EXCEPFION be reported witt 
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Oe considered a program error if either condition occurs and the 
program wild be discontinued. 


The precise meaning of EQF on READ i858 that (a) the last writer on 
this Queue has closed his Queue Fite and {b) the Queue is eapty. 
EOF is treated as a pseudo~message in the Queue. That ts+ when 
the hast massage has been read from the Queue File» the Fite 
stilt exists and actuaily remains "not empty” for WAIT purposes. 
A subsequent READ wild resuit in the EDF branch being taken. The 
Queue is then empty» but stitd in EOF status» so if yet another 
READ is issued on the Queue Filer the reader witl again take the 
EOF branch. EOF can be cdieared by either the reader closing and 
reopening the file or by the opening of the Gueue by a new 
writer. 


READS to specific members of a Queue File Family are treated 
exactiy dike READS on single Queue Files. An unspecific READ on 
a Queue File Family wilt return EOF only if all mempers of the 
Famidy are at EGF (i.»a.» amptyr» no writers). When the tast 
writer closes any member queue of a «FF, the event 
@eoWRITE.OCCURRED will be caused for the Q@FF> this witt put a 
reader in the READY.@ when it WAITS on this event. 


A MESSAGE COUNT communicate operator is implemented to enabie 
user programs to determine if any messages are oresent in the 
Queue Files they are using. This function is described in a 
later paragraph. A MESSAGE COUNT communicate issued for 2 Queue 
that is marked as being at END*OF°FILE witt show the EDF status 
as a oseudo "message = the count For that particular Queue Fite 
widi be one more than the count of real messages. When the 
reader executes a specific READ on the member Queue which is at 
EDF» the EGF branch will be taken. The naxt MNESSAGE.COUNT wiil 
show the member Queue as containing no sessagese Another READ on 
the member witl resutt in the EF branch being taken again» as is 
done for a single Queue File. 


On Queue WRITE operations» ENOD-OF]=FILE is not defined and wiil 
never occure EXCEPTION has the same meaning as it dees for READ 
operations =~ it denctes an invalid key condition on Queue Fite 
Famidies only. INCOMPLETE°IO widtd be reported» if requested» 
when the Queue is futi and there is no space available to store 
the message that ts being written. If no INCOMPLETE“10 raport is 
rquested and the Queue is full when a WRITE occurss the orogras 
is suspended until space is available in the Queue. 


As mentioned previousty» when a togicat I/0 request is directed 
to a Queue File Family» a key must be included to identify tha 
specific Queue in the family to which the operation is directed. 
This is similiar to Switen Files in the ‘SDL Language. Famity 


ie 


BURROUGHS CORPORATION COMPANY CONFICENTIAL 
COMPUTER SYSTEMS GROUP B1LO0C MCP II 
SANTA BARBARA PLANT PeSe 2212 5462 CE) 
members are numbered dogicaily from one to n. Giving a key of 
zero on a READ is defined as an unspecified read. The rambers 


widd be searched» beginning with number onesr and the first queue 
member found not empty will be read. <A key of zero on a write is 
invalid. 


WRITING TQ THE TOP OF A QUEVE EILE 


Writing to the top of a Queue File is ailowed in the MCP though 
it may or may not be altowed in a given tangquage. A message 
written to a queue file normatiy goes to the bottom of the Queue 
though some rare occurrences in applications may require the 
conver sae. This capability is invoked in the communicate 
operation by setting bit 7 of CT.ADVEREB. 


MESSAGEACOUNT COMMUNICATE 


This communicate operation returns the count of messages in the 
Gueue Fite specified. If a Queue File Family is specifiedrs the 
count of each member will be returned in an array (member one in 
the first position» member tuo in the seconds etce}» up to the 
limit of the result fietd. Counts wili be returned either in 
decimat (COBOL "PICTURE 999") or binary CSDL "BIT(24)") depending 
on the value of the first bit of CT.ARVERB. This operation may 
not be implemented in ali tanguages. 


Format: 
CT.~VERB 48 CHEX 3302) 
CT.-QBJECT File Number 
CTaADVERSB BIT 1 Decimal format results if true 
Ci.l Resudt fieid tength in bits 


CT.2 Resutt field address 
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Reader Fis Writer FI 

RRRKRAKEKKRKRKEHKAK Keka RKAKAKAERKaA EH 
* Device=Queue * * Device=Queue * 
tt x * te 
& * x * 
kKkk&tkkhkhkhhthkkhk Queue Descriptor kh k ehhh hk kk the 
* @ WEY i piciniet & tet eee eee eee ee EELS SL © Ee aoe Q KEY ie 
kakkhbkkkhehkekknk * QeLABEL="MY 2a" * KKeKKKRAKAKaEKKAKE 
& Read * & Q.MAX.MESSAGES=10 * & Write * 
*I0 Descriptor * * Q9oMSG»COUNT=3 * “<>*T0 Descriptor «* 
kk&keEKRKeE KKK KA EAE * Q.8uUFFERS=2 * 1 kkk kkkki&tbehkik&aeee 

* @Q@e.NOT.FULL=TRUE * | i} 

s* @eNOT~EMPTY=TRUE «® Sess SS" {1 

i a alec a Q.FIRST fe 1 1 f 

j ee ee QeLAST * i ij 

1 4 ReREKKKAKRKRKRRKRKAKKKKRKE j } 

i (er ss ose SSS aS SS SS eS eS ( i} 

1 sMD1 MD2 MD3 ] ¥ ii 

kA KRRAEKEREABEM MOM DRAKE KKK AKON TOAD KRARARKAEAKRKKKH KK AK } J 

* IN S-Nemory * * On Disk i * In Process Out * a | 

REKKRKKARKAKAEKER TNO OM HEAEARKAKAKRKAAKRAEAC MO OMKEAKAKHHAKRAEKEKAKNA 4 4 

i i 1 i 

1 { Ma ia 

MS y i kk kKKAKRKAA KEE RANE 44 

KRREKKAREKKKEAKKEHEEE j * "THIRD MESSAGE «2<<-]3 Jj 

* "FIRST MESSAGE « | id TEXT? * i 

te FEXT*™ & i KRERKEKRAKAEERKAKEKNEAREH j 

kekKaEKERKKKAREKKK j j 

| RaARKREKERAKERAEEREREERERERAL { 

1 i System Disk t ! 

i PES TESCE RSS ESLOLO SLES LSE © i 

H & * j 

j keeaKKKKKKKRKEaAKRREH KKK HRA i 

jrecrero>e "SECOND MESSAGE TEXT" j 

cheek kkknkkkkakachkkk ket | 

* "THIRD NES > usw ee eete oe agqeon | 


Figure 8-1: 


RAKRAKEKKKAHEKHEKREREKKRKRAKaAAE 
&® & 
Ree KEKEKEKEAKKEAKRHEEAREKK 


Two Programs Communicating in a Queue File Catled *MY.G”". 
The Queue contains three messages. 
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Fis 

kaekkkkh kh keke ekhehhkheehaekkeek 

"MY.OFF™ * 

®* FIB.MYUSE = INPUT/GUIPUT « ReRAKRAKKEAKRAKAKKaARREEAK 
* FIB.Q-FAMILY = TRUE * * "MY.OFF™ ® 
* FIBeQ.FAMILYs»SIZE. = 3 * * "ga00000001 il 
w#tkkkekkkhkkkkkhkh ke hkekhk kkk ra Q.BUFFERS = ? & 
* QeKEY 1 & * QeMAX.MESSAGES=10 * 
RaEKKKKhKkkEhh a KkKkkkeke kak kkk hk ak kk * 8.”M5G.CT = QO * 
& QesKEY ? * RRKKEKRAKEREEAHREEK ER 
Pee ee PER ESE RE RE SLO REPS RES ES ES * FIRST & LAST & 
* QeKEY 3 Po kkkkkkh kkk eehhhhee eee 
kkk khkkkkkhkeakekkkakk kha keer 

i READ I0 DESCR i 

kaekekhkk kkk kkk ekakhkkkktkkhhkkek 

* WRITE I0 DESCR * 


(2ee SERRE SRE SR EL ESSER SRS EES ES Se 


REKKRAKRAKaEKKKEKRKKRARKEKEKE 


* "MY .QFF*" * 
* "2800000002 & 
* Q.BUFFERS = 2 te 
* Q.MAX.MSGCOUNT=19 «* 
ie Q9eMSG.CT = i MD 
REKEKAEKEKKReE KHAKI KEKARHKKKXHKEKRE 
* FIRST «* LAST t al i 
ReREAKKRKKKKK KKK KKKRKEEKEK kKRaKKEEREAAAREREAS 
WCEKRKKKERHKRKKREKREKKKKE RAKES 
* "MY.OFF? & 
* "#200900003 * 
* Q.-BUFFERS = 2 * 
* QeMAXNSG.COUNT = 10 «& 
* Q.MSG.CT = 2 a MO MD 
MERE KHERKEEEEKKEEREKEKKRKE KEKE E RKRKEKKAKEKKERKKERES TERE ER ESE SSE FS 
« FIRST co LAST * o te * * 
kahkk&kekxkczakrk hk kkkkekk kkk k Akkk kk ke KKRKEKK EK R&kEkXaKEKR EAE 


Figure 8-2: <A Queue-file Family with three members. 
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INTER“PROGRAM COMMUNICATION 


Another means of accomplishing inter-process communication is the 
Inter-Program Communication Moduie» first implewented in the 9.9 
software to satisfy the requirements of the ANSI "74 COS80L 
Language. According to the specifications of that languagere the 
facility provides synchronous CALL and EXIT verbs» as well as a 


shared data inptementation. The modudle provides a facitity to 
transfer control from one program to another and the ability for 
both programs to have access to the same data items. The names 


of the programs to which control is to be passsed way or may not 
be known at compile time. Additionally» this module provides tha 
ability to determine the availabitity of memory for the programs 
to which control is being passed. 


BUN UNIT DEFINITION 


The definition of a "Run Unit" is criticat to the implementation 
of the CALL/SCANCEL mechanism described in the ANSI "74 COBOL 
specifications. The execution of any program via an EXECUTE 
controd instruction does not establish a Run Unite A Run Unit is 
established only when an executed program initiates another 


program via the CALL communicate. That calfied program is now a 
sember of the Run Unit associated with the program that was 
originally executed. Simitarty» any program calded by a program 


within the Run Unit becomes part of that Run Unit and remains in 
that Run Unit until terminated or canceited. A job cannot be a 
mamber of more than one run unit. The fotltowing figure 
represents seven programs CA >= G6) which have been catied within a 
run unit. 


CA was Executed) 


A 
j <er-- Current Path 
B 


Previous “""*7> » \ 
Path .D 


The connecting Links are generated by and represent the last used 
path» and the tink exists until araturn CEXIT PROGRAM) is 
accompdished.s. Once a cadied program has been exited (Dx Fe Ga)» 
it remains suspended in its current state» The only path that is 
of interest 35 the path last traversed. 
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The current path is important in order to check the validity of a 
CALL or CANCEL statement? if a program tries to CALL or CANCEL 
itself or any of its predecessors» the entire run unit wilt be 
0S*ed. The other dinks are unimportant» as any program in the 
run unit can CALL or delete other existing programs» With the 
previously mentioned exceptionsse or can CALL new programs. 


If» for example» orogram *E* canceds program 72° then the Run 
Unit would consist of ali of the following programs and appears 
as: 


Unattached 
Programs 
Fe 


A CALL to any of these programs will resuit in a transfer of 
control to the existing state» whereas a CALL to any other 
programs inciuding "D%s widi cause an initial state copy to be 
invoked before controdt is transferred. The termination» via STEP 
RUN or ABORT» of any program in a Run Unit witd resuit in the 
removat of alt programs in that Run Unit from memory. 


TPC THELENENTAIZON OF SHARED QATA 


For those not famiijiar with the ANSI *74 COBOL definition of 
Inter*Program Communication» ali programs within a-Run Unit 
execute synchronously» No two programs in a Run Unit may be 
executing simultaneousty at any time and consequently» there are 
no problems associated with two or more programs contending for 
the use of shared data» Control is passed to 4a program via the 
CALL verb. The program which contains the CALL widl mot be 
atiowed to execute again untiat the cadied program perfcras an 
EXIT PROGRAM verb. 


The catfling program may specify one or more data items toa which 
the calted program has access. The shared data may be any OL or 
YY? devel item described in the cadding program This inctudes 
items whose addresses have been received through a CALL. The 
data items may be named and defined differentiy in each program 
as long as the tlength of the item remains the same in each 
program. This mechanis# is strictly a “pass by name” facility. 
Parameters cannot be passed by value. Additionatty» storage for 
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the shared data is never allocated in the catlied program. In 


other wordse the address of the data» onty» is always passed to 
the cadied orogram. 


IPL BUN STRUCTURE NUCLEUS CHANGES 


In order to maintain ail of the necessary information regarding 
the programs which comprise a Run Unit» several fietds were added 
to the Run Structure Nucteus» RS»eNUCLEUS» the field in memory 
which contains information about each program that is executing» 
in the 9.0 version of the MCP. This fieid»s as it has aiways 
beens is shared by the Operating System and the user program's 
interpreter, The foltiowing is a list of the fields which were 
added in the 9.0 version and a brief description of each. 


RoeRUNeUNIT g17416) 


When a job initiates a CALL» he establishes a RUN UNIT. This Run 
Unit is identified by his own (the originator’s) job number. 
RS eRUNUNIT> for any job in the Run Unit» witi contain the job 
number of the program which initiated the Run Unit. 


RS2RUNeUNTTeLINK BIT¢19) 


This fiedd wifl contain zero for the job that initiated the run 
unit and for any job in the Run Unit that has done an EXIT 
PROGRAM. For any joo that is currentiy active in the Run Units 3a 
job that has not done an EXIT» this fieid will contain the jos 
number of his caider. 


R52TPCeDICT BIid 24) 


This fietd wili contain the absolute address of the 
IPC.DICTIGNARY through which ecarameters wild be accessed within 
the catling job's base-timit space» The fielda witt be zero if 
the dictionary does not exist. This is the List of parameters 
that this job wild pass. The IPC.DICTIONARY is adjacent to the 
RS»NUCLEUS and found only in the catlers Run Structure Nucteus. 
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RS2TPCsPARANETER LIST BLiC24) 


This fietd widd contain the absolute address of the 
IPC.~PARAMETER.~LIST. This space will be adjacent to the Run 
Structure Nucteus for any called job that can receive parameters. 
The IPC»PARAMETER.~LIST witli be a series of 24 bit fields. The 
first fieid will contain the number of parameters that this job 
is capable of receiving. The remaining fieids in the tist wiit 
contain the length in bits of each parameter. This list is built 
ondy for the called program from the IPC.PARAMETER.LIST in the 
catled program*s code file that is generated by the compiler. If 
the job cannot receive parameters» this field wili contain zero. 


Adel PCeQCTeSiZe BITis62 


This fiedid wild contain the nusber of entries in this program's 
IPC Dictionary. 


RSsEXECUTE TYPE BIIt42 


This fieid is used to store the type of execution that originated 
the job. If the job is not an Execute type or a Cali type» then 
it cannot be catied. The field can contain the fodlowing vatues: 


Execute 

Compite and Go 

Compiie for Syntax 

Compile to Library 

Compite and Save 

Go Part of Compile and Go 
Go Part of Compile and Save 
Cait 


Sw ob Um wR om 
i it tt Wo ou ot 


RS2NAME CHARACTER(392 


This fieid witl contain the name of this program. In the casa of 
compilations» denoted by he vatue of the previous fieid» it witt 
contain the name of the compiler as weil. 
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RSaCALLERS ALB B11(24) 
This fieid widil contain the Limit Register of this job's caller. 
RSelPCeEVENT BIT £12 


This field is a dummy event for any IPC hang or suspension of 
executions If a program is waiting on RS.~IPC.EVENT and is 
currently passives which wit be indicated by a zero vaiue in 
RSeRUNUNTITLINK» the RS»«STATUS wild be set to a vatue to 
indicate "Waiting to be Catited™. If the program is currentty 
actives indicated by a non-zero value in RS~RUN.UNIT.LINK » the 
RS»«STATUS will be set to a value indicating “Waiting on caltea 
program". 


RS2CANCELED S1TC12 


If this boolean is trues then at feast one CANCEL communicate has 
been issued against this program. When this is true» this 
particular job is effectively no longer a member of the Run Unit 
and is waiting to be terminated by the SMCP. 


GPC Programs Parameter Block Changes 


It was also necessary to make changes in the Program Parameter 
Blocks the tworsector field that is generated by the ccnpiters 
and stored in the code file>» to .accomodate the iPC 
implementation. A dist of the fields that have been added is 
presented betow. 


PROGeTPO»SIZE G1If182 


This fieid indicates the number of eantries in the 
IPC.»PARAMETER»LIST. If tnis fieid is not equal to zero» it 
indicates to the MCP that this program can onty be called - it 
can never be EXECUTEd. 
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PROGeIPC2PIR B11424) 


This field is used to store the relative disk address in the code 
file of the IPC.»~PARAMETER.LIST.» The IPC.PARAMETER.LIST will be a 
series of 24 bit fieids that contain the length in bits of the 
parameters that may be passed to this program with a CALL. 


PROGsIPCeMAX2SENDsPARAMS BIEC15) 


Thais field indicates the maximum number of parameters to be 
passed by this program through a CALL» which wilt aiso be the 
number of entries in the IPC Dictionary. 


It was adso necessary to add a fieaid to the format of the Progras 
Parameter Stock that is used by the MCP after the job is 
scheduled for execution. This field» known as PPB.RUN.UNIT> is 
Sixteen bits in Length and js used to contain the Job number = of 
the run unit that this program wili become a part of. 


JPCeDICTIONARY 


The IPC.DICTIGNARY is a tist of System Descriptors built by the 
program to describe the parameters to be passed on a CALL. This 
dicttonary wilt be within the space defined by AS.2.IPC.DICT in the 
RS~NUCLEUS of the cad@ing program. The tength of this dictionary 
is passed in the CALL communicate. The Micro MCP wilt verify 
that the number and tength of parameters passed match the 
IPC»PARAMETER.LIST of the calied progran. 
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ZPC COMMUNICATE OPERATOR 


Gne new communicate operator was added to the Operating System to 
accomodate the IPC implementation. This operator is generated by 
the Compiisrs to implement the CALL» CANCEL and EXIT PROGRAM 
verbse It may De handled by the Micro MCP or the SDL MCP» 
depending upon the circugstances. Its format is presented below 
and in the Demand Managewpent section. 


CYr.VERB 43 
CT.OBJECT 0 = CALL 
1 = CANCEL 
2 = EXIT PROGRAM (No EDI) 
CT.~ADVER® Bit 
0 ~ 4f CALL» return on NO MEMORY 
imli - Not used 
CTal Base relative address of a 30 character 
fieid that contains the name of the job 
to be cadied or cancelied. 
Cte Number of parameters to be passed 


RSeREINSTATE~MSG.PTR values returned if requested: 


0 - Communicate completed as requested. 
1 * For CALL» insufficisnt memory to compiete the CALL. 
- For EXIT PROGRAM» the program was initiated by an 
EXECUTE instruction as opposed to a CALL. 
- Not used for CANCEL. 


TPe Yerb OQoeratian 


One of the primary objectives of the IPC implementation was 
performance. Therefore» as much as possible of the IPC function 
was implemented in the Micro MCP. In the ANSI "74 COBOL 
Language» the CALL and CANCEL verbs require the specification of 
program names within the source text. On the 81000 syste» the 
name of 4a program may be unknown to the user when the program is 
compiled» since the Run Unit may be executed under a Usercode. 


To simplify the task of associating program names with those 
specified by a program in a CALL or CANCEL communicate» a new 
system structure was implemented. A programmatic description of 
the structuree IPC.RUNUNIT.~LIST» is presented betow 
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OL IPC.RUN.UNET.LIST BITC320)> 

O2 IPC.RUN.UNIT»NUMBER BIT (16)> 

02 IPC+PGMNANE CHARC30)> 

O02 IPC.PGM.J0B NUMBER BIT (16), 

02 IPC»PGM.LR BIT (24), 

O02 IPCsFORWARD.LINK BIT €24)3 


IPCeRUNUNIT.LIST is a fdinked serial tList which inctudes att 
members of ait Run Units. The entries in this list aren*t in any 


particular order and are not grouped by Run Unit. The SOL 
portion of the MCP is responsible for the managemert = and 
maintainence of add IPC».RUN.UNIT.LISTs. The first 


IPC.RUNUNIT.LIST is addressed by a field in the MCP*"s stack. 
Soth the Se.MCP and the Micro MCP (M.MCP) access these structures 
for information. 


IPS CALL OPERATION 


The MICRO MCP receives all CALL communicates. Any named job is 
considered a candidate for a CALL by the Micro MCP. If the 
requested job is not currently a member of the correct Run Unites 
then the CALL request will be transferred from the Micro MCP to 
the SDL portion of the MCP» to make the calied program present. 


To determine if the requested job is a member of the correct Run 
Unite the Micro MCP searches the tist of Run Units» beginning 
with the first» which is addressed by a fieid in the MCP stacks. 
Each program that is 2a member of any Run Unit wilt be found in 
the serially link tist described by the IPC.RUN.UNIT.LIST 
structure. 


If the program is present» the Micro MCP will first examine the 
program*s RS~CANCELED boolean in its Run Structure Nucteus. If 
this pbpooctean is truep then this copy of the program has beer 
cancelled and a naw copy must be initiated. CANCEL operations»e 
like ail program termination operations do not happen 
immediately. If a new copy must be initiated» the Micro MCP witd 
cadi the S.MCP to initiate a new copy of the same program. 5.MEP 
operations» upon receiving a CALL communicate» are described in 
later paragraphs. 


If the RS.CANCELLED boolean is false» then the Micro “CP checks 


to determine whether the cailed job is active or passive» which 
will be indicated by the R5.RUNUNIT~LINK field of tha Run 
Structure Nucteus. if the job is atready actives ther some 


theoretically impossible error has occurred and the Micro MCP 
must cali the S.NCP so that the Run Unit can be terminated. If 
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the called program is found to be passivere then the Micro MCP 
will next check to insure that the number of parameters to be 
passed» if any» agree. This wilt be indicated by the catling 
program’s RS»IPC.OICT field being equal to the caitiied program's 
IPC.~PARAMETER.~LIST. 


If the number of parameters do not match» then the Micro MCP 
catis the S.MCP for termination of the run unit. If the numbder 
of parameters do agreer the Micro MCP next checks to insure that 
the dength specified for each passed parameter is the same in the 
cailing program and the called program. Lf any of the length 
descriptions are not equai» the Micro NCP wilt catd the $.MCP for 
termination of the entire Run Unit. 


If parameters are being passed» if the number of parameters is 
equati and if they ali have equat Length attributes» then in the 
catling program*s Run structure Nucleus» thea Micro MCP increments 
the RS~TEMPORARY.FREEZE fieitd» to fix the program in memory and 
sets tha RS~RUN.UNIT.LINK fieid to the caller'’s job number. In 
the Run Structure Nucieus of the called job-p it sets the 
RS CALLERS.LR field to the Limit register of the caiting progran. 
it then hangs the caditing program on its RS»IPC.EVENT fietd and 
sets the cadier*s RS.~STATUS fietd to “waiting on the cailed 
program” and marks the cadded job "ready to run”. It shotid be 
noted that it is not necessary to freeze the calling program in 
memory if parameters ara not passed. 


Considering the case where the catded program is not a mesber of 
the Run Unit and the $.4CP is catiied upon to execute the 
requested programe whenever the $.MCP receives a CALL communicate 
and usercodes are involved» it widt first search the List of Run 
Units» using ail permutations of the usercoded name» to determine 
if the job exists in the Run Unit under a different name. if sa» 
the new name and corresponding information wilt be entered ints 
the Run Unit List and control witd be returned to the Micro MCP. 
If Usercodes are not invodved and if the name does not axist in 
the Run Unit Lists» then execution of the job must be attempted. 


The S.MCP must then determine that the requested program is 
present on diske If not present» the program which issued the 
CALL wilt be hung until the requested program is made present. 
If the requested program is praesent on diske the 5.MCP must then 
determine that there is enough memory to execute the requested 
program. If there is insufficient mamory,» The program which 
performed the CALL may have asked to be notified of this fact. 
If so» the calied job wilt not be scheduled but the progras which 
performed the CALL wild be notified of the insufficient memory 
condition. If the program which performed the CALL did nat 
request to be nofitieds the catied program will be scheduled and 
the catling program wilt not be allowed to execute until the 
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calded program does an EXIT PROGRAM communicate. 


Actually» after the called program reaches 80J» the SeoMCP will 
hang the catlied program on his own RSsIPCeEVENT with RS.~STATUS 
set to “Waiting to be cailed”™ and put the cadling program back in 
the Me~COMNN.@. This adlows the Micro MCP to complete the CALL 
operation. 


TPC CANCEL OPERATION 


Ail aspects of the CANCEL and EXIT PROGRAM communicate opertors 
are handied by the Micro MCP. Upon receiving a CANCEL operator» 
the Micro MCP aust first determine if the job exists in the Run 
Unit and whether it is active or passive. If it is not frresent 
or the program is oresent but its RS»CANCELED boolean is true» 
the request is ignored and the canceiting job is reinstatede if 
it 3S present and passives the Micro MCP will then place the 
specified program in the EXTERNINATE.Q» set the RS.CANCELED 
boolean and return control to the job shich issued the 
cOmmMUNiCcate. The EXTERMNINATE.» wild cause termination of the 
job. 


A request to CANCEL a job that is both a member of the Run Unit 
and active is a violation of the COBOL specifications and wilt 
resuit in termination of the entire Run Unit. 


Lec EXIT PROGRAM OPERATION 


If a catted job issues an EXIT PROGRAM communicate operation» the 
Micro MCP wild hang the issuing program on its RS~IPCJEVENT 
fietd» setting RS.STATUS to "Waiting to be caitled"» decrement 
RS»~TEMPGRARY.FREEZE in the Run Structure Nucleus of the program 
that catied the issuing program and mark the cailing program 
ready to Tunes If a program that was not called issues the 
communicates the communicate widl be ignored and controt will be 
immediately returned to that program. 


TPC TERMINATION CONSIDERATIONS 


If any program in a Run Unit performs a STOP RUN communicate 
operators the entire Run Unit wild be cancetied and ali progrars 
in the Run Unit widd be discontinued. ‘Similariy» if any program 
in the Run Unit terminates abnornaily» the entire Run Unit will 
be discontinued. Programs within a Run Unit may only stop 
execution via the EXIT PROGRAM verb. Normal termination wiii 
occur when the program that initiated the Run Unit terminates. 
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Upon termination» for any reasoner of any member of a particular 
Run Units» the S.eMCP will ainmediately delink adil entries 
pertaining to the specified Run Unit from the Run Unit List. 
When the parent of a Run Unit goes to a normal EDJ» then atl jobs 
attached to that run unit will be canceiled. If any job in a run 
unit is aborted» then the entire run unit wilt be aborted. If 
one program in a Run Unit does a CANCEL on another programs in the 
same run unit» then the canceiiled job must be detinked fro# the 
run unit and sent to EOJ. 


TPC MICRO MEPL Se NEP COMNUNICATION 


The transfar of information between the Micro MCP and the 5.CP 
is accomplished using an existing mechanism. This techanisgr 
utilizes the Run Structure Nucteus fietd» RS5S.MePROBLEM. Ala 


required communication are shown in the 
following table. The table shows the vatue that will be stored 
in the RS.~MPROB~P2 fieids a subfteid of RS.MePROBLEMs the 
condition that caused the communication and the action that will 
be taken by the 3$.4CP. Whenever such communication is necessary 
the RS.~MPROS.P1 fieids also a subfield» witli be set to a waiue of 
92 which with indicate the family of oroblems related to IPC. 


instances of such 


RS»MPROSG.P2 = Error Dascription Required Action 
0 Requested program not S»NCP shouid make 
not in Mix. program present. 
1 Number of parameters SeMCP will OS entire 
do not match. Run Unit. 
2 Parameter specs. SeMCP witt O35 entire 
do not agrees Run Unit. 
3 Attempted recursive SoMCP wiil DS entire 
CALL Run Unite 
4 Attemoted CANCEL SeMCP wili OS entire 
of predecessor. Run Unit. 
5 Invalid Communicate SeMCP widdi OS entire 
parameters. Run Unite 
6 Found requested job Terminate specified 


and RS»CANCELED true joo and make new 


copy present. 
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2PC CROGRAN QUMPS 


If any member of the Run Unit»e regardiess of whether the 
specified program is active or passive is 05*ed» DP-ed» or DM-red>» 
the entire Run Unit wiit be dumped and» if OS~ed or OP-eds 
terminated. 


420 CANDIDATES EQR ROLLOUT 


After the Micro MCP processes an IPC communicate» at will not 
purposely mark the appropriate job TO.8E.ROLLED.QUT. If the 
SeMCP needs memoryr ait will follow the normal selection process 
in determining a candidate{s) for Roliv-out. There with 52 no 
speciai consideration given to members of Run Units. 


fee TASK CONSIDERATIONS 


Each caited program wili actually become a TASK associated with 
the originator of the Run Unit. By becoming a TASK as opposed to 
a normal job» several advantages wiili be realized. 


1) TASKS are not subject to MIX Limits and other scheduling 
constraints. 
Z)> There wild be corresponding entries in the SYSTEM/LOG. 


TPC PROGRAM NAME SPECTEICATIONS 


Information passed for the orograss name in the CALL/CTANCEL 
communicate witli be subject to the same naming restrictions as 24 
file with respect to DS or DP conditions» esge» CALLing a program 
with a blank MWFID will result in the termination of the entire 
Run Units , 
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